Getting Started

Set up your local development environment and start running STORM DAY in minutes.

Prerequisites

Environment Variables

Each service requires specific environment variables. Here are the key configurations:

NATS_URL=nats://localhost:4222
JWT_SECRET=your-secret-key
HTTP_PORT=8080

DB_HOST=localhost
DB_PORT=5432
DB_NAME=storm_user_db
DB_USER=postgres
DB_PASSWORD=postgres
JWT_SECRET=your-secret-key

STORAGE=postgres  # or "memory" for testing
HTTP_PORT=8081
NATS_URL=nats://localhost:4222
DATABASE_URL=postgres://postgres:postgres@localhost:5432/storm_chat_db

Local Development Setup

Follow these steps in order to start the full stack locally:

docker compose up -d postgres-user postgres-chat nats redis

cd services/user
DB_NAME=storm_user_db npm run start:dev

cd services/gateway
go run ./cmd/main.go

cd services/message
STORAGE=postgres HTTP_PORT=8081 go run ./cmd/main.go

cd STORM_DAY_Project_Front
pnpm install
pnpm dev

Vite Proxy Configuration

The Vite dev server is configured to proxy API requests to the Gateway:

// vite.config.ts
export default defineConfig({
  server: {
    port: 5174,
    proxy: {
      '/api': 'http://localhost:8080',
      '/auth': 'http://localhost:8080',
      '/users': 'http://localhost:8080',
      '/ws': {
        target: 'ws://localhost:8080',
        ws: true
      }
    }
  }
})

Production Environment

Troubleshooting