Personal website repository with:
- Frontend: Vite + TypeScript multi-page app
- Backend: FastAPI service
- Web server: Nginx (Docker Compose)
frontend/ Vite source
index.html
docs.html
apps/
demo/
graph-platform/
src/
pages/
home/
docs/
apps/
graph-platform/
shared/
styles/
backend/ FastAPI service
src/main.py
data/ Runtime data (gitignored)
public/ Generated static output (not tracked)
nginx/
default.conf
docker-compose.yml
deploy_vps.sh Linux VPS deploy script
deploy_local.ps1 Windows local deploy script
package_for_vps.ps1 Windows packaging script (zip for manual upload)
- Node.js + npm
- Docker + Docker Compose
- Git
cd frontend
npm ci --include=dev
npm run buildBuild output goes to public/.
docker compose up -d --buildHealth endpoint:
http://127.0.0.1:<WEB_PORT>/api/health
cd website_development
bash deploy_vps.shOptional English output:
DEPLOY_LANG=en bash deploy_vps.shScript flow:
- Check Git working tree is clean
- Pull latest code (
git pull --ff-only origin main) - Install frontend dependencies
- Build frontend
- Rebuild and start Docker services
- Read
WEB_PORTfrom.envand run health check on that port - Print service status and health check result
cd website_development
.\deploy_local.ps1Optional:
.\deploy_local.ps1 -Remote origin -Branch mainpackage_for_vps.ps1 is a Windows helper script for packaging the project into a zip file (deploy_package.zip) for manual VPS upload.
Use it when:
- You do not use
git pullon the server - You want to upload a deployment package via panel/file manager
What it does:
- Creates a temporary folder
- Copies project files while excluding
.git,.venv,node_modules, logs, and cache files - Generates
deploy_package.zip - Cleans temporary files
Run it on Windows PowerShell:
.\package_for_vps.ps1cd frontend
rm -rf node_modules
npm ci --include=dev
npm run buildOptional check:
ls node_modules/@fortawesome/fontawesome-free/css/all.min.cssCheck changed files:
git statusRestore a single changed file:
git restore <file>- Frontend generated output is not tracked in Git.
- Do not commit runtime data in
backend/data/. .envis not committed. Use.env.exampleas template.