SUpost Full-Stack Prototype

This repository now contains:

• Go backend (supost serve) exposing REST APIs
• Next.js 16.1.6 + TypeScript frontend (frontend/) rendering the SUpost-style homepage
• Supabase/Postgres integration through the Go repository layer

Architecture

Backend (Go)

• Command layer: cmd/
• Business logic: internal/service/
• Domain contracts: internal/domain/
• Data access adapters: internal/repository/ (inmemory and postgres)
• Vercel Functions handlers: frontend/api/*/index.go
• Vercel Go runtime module: frontend/go.mod

The backend API surface is the same for local server and Vercel functions:

• GET /api/categories
• GET /api/subcategories?category_id=<id>
• GET /api/posts?category_id=&subcategory_id=&status=&limit=&offset=
• GET /api/health

All responses are JSON, with structured error envelopes for validation/internal failures.

Frontend (Next.js App Router)

frontend/ includes:

• app/ page, layout, loading/error states
• components/ modular homepage sections
• services/ typed API client to Go backend
• types/ API response/domain types
• hooks/ UI helper hooks

The homepage is rendered from modular React components and fetches data only from the Go API.

Environment Variables

Backend (.env)

Use .env.example at repo root:

• DATABASE_URL (optional; if empty uses in-memory repository)
• PORT (default 8080)
• CORS_ORIGINS (comma-separated origins in addition to localhost:3000 defaults)
• SUPABASE_URL, SUPABASE_ANON_KEY (for shared config compatibility)

Frontend (frontend/.env.local)

Use frontend/.env.example:

• NEXT_PUBLIC_API_BASE_URL=http://localhost:8080
• DATABASE_URL=postgresql://... (required for Vercel Go functions)
• CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000

Run Locally

1. Backend

go run . serve --port 8080

2. Frontend

cd frontend
npm install
npm run dev

Open http://localhost:3000.

Deploy To Vercel (Single Project)

Deploy frontend and Go API together as one Vercel project.

1. Vercel Dashboard Settings (Project Settings -> General)

Setting	Value
Root Directory	frontend
Framework Preset	Next.js
Node.js Version	20.x or newer

Vercel will deploy:

• Next.js app from frontend/app
• Go serverless functions from frontend/api

2. Environment Variables (Settings -> Environment Variables)

Add these for Production and Preview:

Variable	Value	Required
DATABASE_URL	postgresql://... (Supabase pooler URL)	Yes
CORS_ORIGINS	https://<your-project>.vercel.app (no trailing slash)	Yes
NEXT_PUBLIC_API_BASE_URL	Leave empty to use same-origin /api on Vercel	No

Your local .env/.env.local files are not deployed. Set vars in the Vercel dashboard.

3. Deploy

vercel --prod

The homepage and API will be served from the same URL:

• https://<project>.vercel.app/ — Next.js homepage
• https://<project>.vercel.app/api/health
• https://<project>.vercel.app/api/categories

Validation Commands

Backend:

go build ./...
go test ./...

Frontend:

cd frontend
npm ci
npm run typecheck
npm run build

Notes

• If DATABASE_URL is set, backend reads from Supabase/Postgres.
• If DATABASE_URL is empty, backend serves seed-backed in-memory data.
• Frontend route / is intentionally dynamic (force-dynamic) so production builds do not require a live API at build time.
• Local CLI server (go run . serve) and Vercel functions share the same service/repository business logic.