Merge feature/full-frontend-v1 into main (initial frontend codebase by Yamen)

Made-with: Cursor

.gitignore

@@ -4,9 +4,13 @@ node_modules/
 # Build output
 dist/
 build/
+.next/
+out/
 
-# Environment
+# Environment / secrets — never commit
 .env
+.env.*
+!.env.example
 .env.local
 .env.production
 .env.*.local
@@ -25,9 +29,5 @@ Thumbs.db
 # Logs
 *.log
 npm-debug.log*
-
+yarn-debug.log*
-# Testing
+yarn-error.log*
-coverage/
-
-# Vite
-*.local

README.md

@@ -1,3 +1,24 @@
+# EnCoach Frontend — v2
+
+## Branching Workflow
+
+This repo is connected to the staging server via a Git post-receive hook.
+**All deployment is automatic — but only after code review approval.**
+
+### How to contribute
+
+1. Never push directly to `main` — branch protection will block it.
+2. Push your changes to your feature branch (e.g. `feature/full-frontend-v1`)
+3. Open a Pull Request on Gitea targeting `main`
+4. Request review from **devops (Talal)**
+5. Once approved and merged, the staging server rebuilds and redeploys automatically.
+
+### Environment
+
+The `.env` file is **not committed**. It lives only on the staging server at `/opt/encoach/frontend-v2/.env`.
+
+---
+
 # EnCoach — Adaptive Learning Platform (Frontend)
 
 The frontend application for the EnCoach Adaptive Learning Platform, serving UTAS university students and freelance learners across IELTS, Mathematics, and IT courses.

docker-compose.yml

@@ -0,0 +1,9 @@
+services:
+  frontend:
+    build: .
+    image: encoach-frontend:latest
+    container_name: encoach-frontend
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    env_file: .env