Duan Nguyen

Portfolio

Public frontend portfolio built with React/Vite and deployed to GitHub Pages.

The FastAPI backend is optional for local development and separate hosting.

Stack

• Frontend: React, Vite, Tailwind CSS
• Backend: FastAPI, SQLAlchemy
• Infrastructure: Docker Compose, Postgres, Redis

Run locally

Frontend preview

From the frontend/ folder:

npm install
npm run dev

This opens the local frontend at http://localhost:5173/.

Optional backend

If you want the local frontend to talk to the FastAPI backend, run it separately from the backend/ folder:

From the backend/ folder:

.\run.ps1

If PowerShell blocks activation, run:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

To run the steps manually instead of using the script:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Public frontend

The public site is deployed from the main branch through GitHub Pages.