Nebula Chat

Nebula Chat is a full-stack AI chat application.
It provides a React frontend for chatting and conversation history, plus an Express backend that streams model responses, stores conversations/messages in PostgreSQL, and caches responses in Redis.

Monorepo structure

nebula-chat/
└── apps/
    ├── nebula-chat-client/   # React + Vite client
    └── nebula-chat-server/   # Fastify + Drizzle API

Prerequisites

• Node.js 24.14.1 (see .nvmrc)
• pnpm >=10
• Docker (recommended for local PostgreSQL + Redis)
• OpenAI API key

Local development (quick start)

1. Install dependencies from the repo root:

   pnpm install
   

2. Create environment files:

   cp apps/nebula-chat-server/.env.example apps/nebula-chat-server/.env
   cp apps/nebula-chat-client/.env.example apps/nebula-chat-client/.env
   

3. Fill required values:

   • apps/nebula-chat-server/.env: at least OPENAI_API_KEY, SERVER_URL, CLIENT_URL, and local DB/Redis values.
   • apps/nebula-chat-client/.env: VITE_API_URL (usually http://localhost:3000 in local development).

4. Start local infrastructure:

   cd apps/nebula-chat-server && docker-compose up -d
   

5. Run DB migrations:

   cd ../..
   pnpm --filter @nebula-chat/db db:migrate
   

6. Start backend and frontend (in separate terminals):

   pnpm --filter nebula-chat-server run dev
   pnpm --filter nebula-chat-client run dev
   

7. Open:

   • App: http://localhost:5173
   • API docs: http://localhost:3000/docs
   • OpenAPI spec: http://localhost:3000/openapi.json

Useful commands (repo root)

pnpm run lint
pnpm run lint:fix
pnpm run format
pnpm run format:check
pnpm --filter nebula-chat-client run typecheck
pnpm --filter nebula-chat-server run typecheck

Deployment URLs

• Application: https://nebula-chat-p3c3.onrender.com/
• API: https://nebula-chat-api.onrender.com

Notes

• Human-focused setup and usage docs are in these README files.
• Agent-specific implementation conventions are documented in AGENTS.md.