Feat/ssr new

.gitignore

@@ -152,4 +152,14 @@ frontend/db/emoji_data/*
 frontend/db/all_dbs/emoji-db.db
 
 # sitemap-checker
-frontend/scripts/sitemap-checker/sitemap-checker
+frontend/scripts/sitemap-checker/sitemap-checker
+frontend/bun.lockb
+frontend/scripts/tldr/sqlite-lookup
+frontend/scripts/tldr/query.sql
+frontend/env.local
+.gitignore
+.gitignore
+frontend/env.prod
+frontend/env.staging
+frontend/bun.lockb
+frontend/scripts/tldr/tldr_to_db

README.md

@@ -206,4 +206,4 @@ We welcome contributions! Here's how you can help:
 6. [MuchiraIrungu](https://github.com/MuchiraIrungu)
 7. [soham-founder](https://github.com/soham-founder)
 8. [Janmesh23](https://github.com/Janmesh23)
-9. [Jayant-Jeet](https://github.com/Jayant-Jeet)
+9. [Jayant-Jeet](https://github.com/Jayant-Jeet)

frontend/.gitignore

@@ -15,12 +15,13 @@ pnpm-debug.log*
 
 # environment variables
 .env
-.env.production
+.env.prod
+.env.local
+.env.staging
 
 # macOS-specific files
 .DS_Store
 
 scripts/tool-banners/screenshots/*
 scripts/pageSpeedReport/*
-
-*.db
+*.db*

frontend/.vscode/launch.json

@@ -5,7 +5,60 @@
       "command": "./node_modules/.bin/astro dev",
       "name": "Development server",
       "request": "launch",
-      "type": "node-terminal"
+      "type": "node-terminal",
+      "skipFiles": ["**/node_modules/**"]
+    },
+    {
+      "type": "chrome",
+      "request": "launch",
+      "name": "Launch Chrome against localhost",
+      "url": "http://localhost:4321",
+      "webRoot": "${workspaceFolder}/src",
+      "sourceMapPathOverrides": {
+        "vite:///src/*": "${webRoot}/*"
+      },
+      "skipFiles": ["**/node_modules/**"]
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Profile Production Server",
+      "runtimeExecutable": "/home/lovestaco/.nvm/versions/node/v22.17.0/bin/node",
+      "runtimeArgs": [
+        "--cpu-prof",
+        "--cpu-prof-dir",
+        "${workspaceFolder}",
+        "--cpu-prof-name",
+        "production-profile-${date:yyyy-MM-dd-HH-mm-ss}.cpuprofile"
+      ],
+      "program": "${workspaceFolder}/dist/server/entry.mjs",
+      "cwd": "${workspaceFolder}",
+      "skipFiles": ["**/node_modules/**"],
+      "sourceMaps": true,
+      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Profile Production Server (Inspector)",
+      "runtimeExecutable": "/home/lovestaco/.nvm/versions/node/v22.17.0/bin/node",
+      "runtimeArgs": ["--inspect"],
+      "program": "${workspaceFolder}/dist/server/entry.mjs",
+      "cwd": "${workspaceFolder}",
+      "skipFiles": ["**/node_modules/**"],
+      "sourceMaps": true,
+      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen"
+    }
+  ],
+  "compounds": [
+    {
+      "name": "Launch Dev Server and Chrome",
+      "configurations": [
+        "Development server",
+        "Launch Chrome against localhost"
+      ]
     }
   ]
 }

frontend/Makefile

@@ -1,8 +1,48 @@
-.PHONY: build deploy run clean gen banners check-pagespeed deploy-no-pagespeed local-env sync-db update-db-to-b2 index-deploy local-prod-build
+.PHONY: build deploy run clean install gen banners check-pagespeed deploy-no-pagespeed local-env sync-db update-db-to-b2 index-deploy serve start-prod stop-prod deploy-staging-ssr
+
+# Run development server
+run:
+	bun run dev
+
+# Clean build artifacts
+clean:
+	rm -rf dist/
+	rm -rf .astro/
+
+install:
+	cd serve && bash setup_dev.sh
 
 # Build the project
 build:
-	npm run build
+	bun run build
+
+serve:
+	bun run serve-ssr
+
+start-prod:
+	cd serve && pmdaemon --config pmd.config.json start && bash pmd-pin.sh
+
+
+stop-prod:
+	cd serve && pmdaemon delete all --force && bash kill-ports.sh && bash kill-ports.sh
+
+deploy-staging-ssr:
+	@echo "⬆️  Deploying SSR build to server..."
+
+	@rsync -rvz --delete --info=progress2 --no-perms --no-owner --no-group --no-times \
+		./dist/ \
+		ubuntu@nats03:FreeDevTools/frontend/dist/
+
+	@rsync -rvz --delete --info=progress2 --no-perms --no-owner --no-group --no-times \
+		./.astro/ \
+		ubuntu@nats03:FreeDevTools/frontend/.astro/
+
+	@rsync -rvz --delete --info=progress2 --no-perms --no-owner --no-group --no-times \
+		./db/ \
+		ubuntu@nats03:FreeDevTools/frontend/db/
+
+	@echo "✅ SSR deployment completed successfully"
+
 
 # Generate all tool banners
 banners:
@@ -34,18 +74,9 @@ deploy2: build
 # Deploy index.html: build then rsync index.html to a4.html
 # Note: rsync without --delete flag will only add/update files, never delete
 index-deploy:
-	npm run build:index
-	rsync -rvz --no-perms --no-owner --no-group --no-times --progress ./dist/index.html root@master-do:/tools/a4.html
-	rsync -rvz --no-perms --no-owner --no-group --no-times --progress ./dist/_astro/style* root@master-do:/tools/_astro/
-
-# Run development server
-run:
-	npm run dev
-
-# Clean build artifacts
-clean:
-	rm -rf dist/
-	rm -rf .astro/
+	bun run build:index
+	rsync -rvz --no-perms --no-owner --no-group --no-times --progress ./dist/index.html root@master:/tools/a4.html
+	rsync -rvz --no-perms --no-owner --no-group --no-times --progress ./dist/_astro/style* root@master:/tools/_astro/
 
 # Generate a new tool (usage: make gen tool-name)
 gen:
@@ -68,36 +99,6 @@ local-env:
 convert-to-webp:
 	./scripts/convert-to-webp.sh "$(src)" "$(out)"
 
-
-
-# Pull all DB files via Git LFS
-# pull-db:
-# 	@echo "🔎 Checking Git LFS..."
-# 	@git lfs version || (echo "Git LFS not installed"; exit 1)
-
-# 	@echo "⬇️ Fetching all LFS objects..."
-# 	@git lfs fetch --all
-
-# 	@echo "⬇️ Pulling DB-related LFS files..."
-# 	@git lfs pull --include="db/**,frontend/db/**" --exclude=""
-
-# 	@echo "📄 Listing LFS-tracked files (only DB paths)..."
-# 	@git lfs ls-files | grep -E "db/|frontend/db/" || echo "No DB files tracked via LFS."
-
-# 	@echo "📏 Showing DB file sizes..."
-# 	@git lfs ls-files --size | grep -E "db/|frontend/db/" || true
-
-# 	@echo "✅ Checking if DB files are actual binaries (not pointers)..."
-# 	@for f in db/*.db frontend/db/*.db; do \
-# 		if [ -f "$$f" ]; then \
-# 			echo "File: $$f"; \
-# 			head -n 3 $$f; \
-# 			echo "---"; \
-# 		fi; \
-# 	done
-
-# 	@echo "✅ DB pull completed."
-
 init-rclone:
 	@echo "⬇️  Initializing Rclone..."
 	@if ! command -v rclone >/dev/null 2>&1; then \
@@ -160,9 +161,5 @@ update-db-to-b2:
 		--progress; \
 	echo "✅ Database file uploaded successfully"
 
-# trigger build locally and deploy to production server via rsync
-local-prod-build:
-	bash ./scripts/local-prod-build.sh
-
 %:
-	@:
+	@:

frontend/README.md

@@ -1,3 +1,49 @@
+## How to setup project
+
+```
+cd frontend
+make install
+```
+
+### Dev
+
+```
+cd frontend
+make run
+```
+
+### Build
+
+```
+cd frontend
+make build
+```
+
+### Serve Built files via bun (simple)
+
+```
+cd frontend
+make serve
+```
+
+### Serve built files via nginx -> pmdaemon -> bun (prod equivalent)
+
+```
+cd frontend
+make serve-prod
+```
+
+### Test all kind of pages
+
+```
+cd frontend/serve
+make curl-all-kind-of-page
+```
+
+###
+
+---
+
 ## How to Test SEO for Your Project
 
 Once your tool is partially or fully completed, you can run validation steps to identify any SEO issues.
@@ -31,29 +77,6 @@ Make sure to follow the same format for any new sections you
 - https://seositecheckup.com/
 - https://rankmath.com/tools/seo-analyzer/
 
-<!-- ## Pull DBs to local repo
-
-Run `make pull-db` in FreeDevTools/frontend folder.
-
-1. List all LFS-tracked files
-
-```
-git lfs ls-files
-```
-
-2. Check whether the actual files (not pointers) are downloaded
-
-```
-git lfs status
-```
-
-3.
-
-```
-git lfs fetch --all
-git lfs ls-files --size
-``` -->
-
 ## Working with DB Files on Backblaze B2
 
 To add or update a database (DB) file for a category:
@@ -86,3 +109,23 @@ To add or update a database (DB) file for a category:
 4. **Referencing in Code**
    - Always reference database files in your code using the path:  
      `db/all_dbs/your-db.db`
+
+## Deploying to Staging
+
+### Step 1: local:
+
+```
+make sync-db-to-local
+make run bulid:icons
+make deploy-staging-ssr
+```
+
+### Step 2: nats03:
+
+```
+cd FreeDevTools
+git pull
+make sync-db-to-local
+make stop-prod
+make start-prod
+```