Social MVP

Nuxt 3 + Go/Gin community MVP scaffolded from project_plan.md.

Stack

• Nuxt 4 with Nuxt 5 compatibility mode, Vue 3, TypeScript, Pinia
• Go, Gin, JWT
• PostgreSQL, Redis
• REST API and room-based WebSocket chat
• Docker Compose and Nginx

Structure

• frontend/: Nuxt application
• backend/: Go API and WebSocket server
• nginx/: reverse proxy config

Quick start

1. Copy .env.example to .env
2. Run docker compose up --build
3. Open http://localhost

Nuxt version note

As of April 5, 2026, the official Nuxt stable line is Nuxt 4.x, and Nuxt 5 is still in development. This frontend is configured to use the current Nuxt 4 release line with future.compatibilityVersion: 5 enabled, which is the official way to opt into Nuxt 5 behavior today.

Notes

• The backend auto-runs backend/migrations/001_init.sql on startup.
• Chat messages are broadcast immediately and persisted asynchronously.
• Redis stores unread counts as unread:{user_id}:{room_id}.