1.4

.gitignore

@@ -7,4 +7,6 @@
 # You might also want to ignore node_modules and build outputs
 node_modules/
 dist/
-build/
+build/
+
+package-lock.json

CONTRIBUTING.md

@@ -0,0 +1,59 @@
+# Contributing
+
+We welcome contributions! Here's how to get started:
+
+1. **Fork the Repository**
+2. **Create a Feature Branch**: `git checkout -b feature/amazing-feature`
+3. **Make Your Changes**: Follow the existing code style
+4. **Test Thoroughly**: Ensure both light/dark themes work
+5. **Submit a Pull Request**: Describe your changes clearly
+
+## Development Guidelines
+- **Follow existing patterns** for consistency
+- **Test on multiple screen sizes** (mobile, tablet, desktop)
+- **Verify theme compatibility** (light/dark modes)
+- **Update documentation** for new features
+- **Add error handling** for robust operation
+
+## Workflow
+
+You can use docker compose like building from source, or you can run the app directly with npm.
+
+
+For local development with hot reloading:
+
+#### Step 1: Install Dependencies
+```bash
+# Backend
+cd server
+npm install
+
+# Frontend
+cd ../client
+npm install
+```
+
+#### Step 2: Configure Environment
+Create `server/.env`:
+```env
+PORT=5000
+```
+
+Create `client/.env`:
+```env
+VITE_REACT_APP_API_URL=http://localhost:5000
+VITE_OPENWEATHER_API_KEY=your_openweather_api_key_here
+```
+
+#### Step 3: Run Development Servers
+```bash
+# Terminal 1 - Backend
+cd server
+npm start
+
+# Terminal 2 - Frontend
+cd client
+npm run dev
+```
+
+You'll want to edit the env variable PORT and set it to 5001 since the client on port 3001 will look for a server existing on port 5001

README.md

@@ -141,20 +141,7 @@ DISCLAIMER: This project uses AI in its development process. While you are right
 
 ## 🤝 Contributing
 
-We welcome contributions! Here's how to get started:
-
-1. **Fork the Repository**
-2. **Create a Feature Branch**: `git checkout -b feature/amazing-feature`
-3. **Make Your Changes**: Follow the existing code style
-4. **Test Thoroughly**: Ensure both light/dark themes work
-5. **Submit a Pull Request**: Describe your changes clearly
-
-### Development Guidelines
-- **Follow existing patterns** for consistency
-- **Test on multiple screen sizes** (mobile, tablet, desktop)
-- **Verify theme compatibility** (light/dark modes)
-- **Update documentation** for new features
-- **Add error handling** for robust operation
+Read our [contributing](CONTRIBUTING.md) guidelines.
 
 ## 📄 License
 

client/nginx.conf

@@ -30,13 +30,15 @@ server {
         proxy_read_timeout 90;
     }
 
-    # Uploads proxy (case-sensitive paths)
+    # Uploads proxy (case-sensitive paths) - must come before static file caching
     location /uploads/ {
         proxy_pass http://${BACKEND_SERVICE}:${BACKEND_PORT}/uploads/;
         proxy_http_version 1.1;
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_cache_bypass $arg_nocache;
+        add_header X-Proxy-Cache $upstream_cache_status;
     }
 
     location /Uploads/ {
@@ -45,6 +47,8 @@ server {
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_cache_bypass $arg_nocache;
+        add_header X-Proxy-Cache $upstream_cache_status;
     }
 
     # Widgets proxy
@@ -56,14 +60,15 @@ server {
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     }
 
+    # Cache static assets from build - but NOT from /Uploads/ or /uploads/
+    location ~* ^/(?!Uploads|uploads|widgets).*\.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        try_files $uri =404;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
     # React Router - serve index.html for all routes
     location / {
         try_files $uri $uri/ /index.html;
     }
-
-    # Cache static assets
-    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
-        expires 1y;
-        add_header Cache-Control "public, immutable";
-    }
 }