A Dockerized notes app with a Go (Gin + GORM/pgx) API, Vue 3 + Vite + TS frontend, and PostgreSQL.

• Go 1.25+
• Node.js 20+ (or the version you use with Vite)
• Docker + Docker Compose (for container workflow)

1. Copy the root env file and adjust as needed:

cp .env.example .env

2. Run the API:

cd backend
go run ./cmd/server

The API listens on http://localhost:8080 by default.

1. Install deps and (optionally) copy the frontend env:

cd frontend/go-notes
npm install
cp .env.example .env

2. Start the dev server:

npm run dev

Set VITE_API_BASE_URL to http://localhost:8080/api/v1 for local API access.

1. Copy env defaults:

cp .env.example .env

2. Build and run:

docker compose up --build

The stack exposes the app through the nginx proxy at http://localhost. To expose the API or the static web container directly, uncomment the ports sections in docker-compose.yml and adjust VITE_API_BASE_URL accordingly.

• PORT (API): 8080
• WEB_PORT (frontend dev): 4173
• DB_PORT (Postgres): 5432
• VITE_API_BASE_URL: front-end API base URL
• CORS_ALLOWED_ORIGINS: comma-separated origins allowed by the API for cross-origin requests

• make api-dev – run the Go API locally
• make api-test – run backend tests
• make web-dev – run the Vue dev server
• make web-build – build the frontend
• make docker-up – build and run the stack
• make docker-down – stop and clean volumes