Personal Portfolio (Nuxt + Django)

This repository is now split into a modern frontend/backend architecture:

• frontend/: Nuxt (Vue) application for the portfolio UI.
• backend/: Django API + admin for projects, services, blog, and contact inquiries.
• docker-compose.yml: Local full-stack environment with PostgreSQL.

What Changed

• Migrated from Django template monolith to split frontend + backend.
• Added Services section support via Django model + API.
• Added Blog section support via Django model + API.
• Added professional Call-To-Action flows:
  • Calendly integration (env-driven)
  • WhatsApp integration (env-driven)
• Switched Python dependency management from pip + requirements.txt to uv (pyproject.toml + uv.lock).
• Added Dockerfiles and Compose stack for local verification before production deployment.

Backend (backend/)

Environment

1. Copy env template:

cp .env.example .env

2. Update required variables in .env:

• SECRET_KEY
• CONTACT_EMAIL
• CALENDLY_URL
• WHATSAPP_NUMBER
• social links

Install and run with uv

uv sync
uv run python manage.py migrate
uv run python manage.py seed_projects
uv run python manage.py seed_site_content
uv run python manage.py runserver

API base URL (local): http://localhost:8000/api/

Useful endpoints:

• /api/health/
• /api/config/
• /api/landing/
• /api/services/
• /api/projects/
• /api/blog/
• /api/blog/<slug>/
• /api/contact/

Frontend (frontend/)

Environment

cp .env.example .env

Set:

• API_BASE_URL (server-side in Nuxt)
• NUXT_PUBLIC_API_BASE_URL (browser-side)

Default local values point to http://localhost:8000/api.

Install and run

npm install
npm run dev

Frontend local URL: http://localhost:3000

Docker Compose

Dev profile (hot reload)

1. Ensure these files exist:

• backend/.env.docker (copy from backend/.env.docker.example)
• frontend/.env (copy from frontend/.env.example)

2. Start dev stack:

docker compose up --build

Services:

• Frontend (Nuxt dev): http://localhost:3000
• Backend API (Django runserver): http://localhost:8000/api/
• Django admin: http://localhost:8000/admin/
• PostgreSQL: localhost:5432

Production profile (Nginx + Gunicorn + Nuxt SSR)

This profile uses:

• Nginx as reverse proxy/edge
• Gunicorn for Django WSGI
• Nuxt SSR runtime (node .output/server/index.mjs)

1. Set production env values (at minimum):

• backend/.env.docker: set DEBUG=False, a strong SECRET_KEY, production ALLOWED_HOSTS, and trusted origins.
• frontend/.env: set public metadata such as NUXT_PUBLIC_SITE_NAME.

docker-compose already pins production API routing to:

• API_BASE_URL=http://backend-prod:8000/api
• NUXT_PUBLIC_API_BASE_URL=/api

Production-oriented examples are included:

• backend/.env.production.example
• frontend/.env.production.example

2. Build and run production profile via Nginx entrypoint service:

docker compose --profile prod up --build -d nginx

3. Validate:

• App through Nginx: http://localhost/
• API through Nginx: http://localhost/api/health/
• Nginx health: http://localhost/healthz

4. Stop:

docker compose --profile prod down

Testing

Backend tests:

cd backend
uv run pytest

Frontend build/type check:

cd frontend
npm run build
npm run lint

Deployment

GitHub Actions and Coolify deployment notes are documented in:

• docs/deployment/coolify.md