Fluxora

Full-stack application with .NET API and Next.js frontend.

Quick Start

Prerequisites

• Docker and Docker Compose
• .NET 9.0 SDK
• Node.js (LTS version)
• pnpm package manager

Development

1. Install dependencies:

   pnpm install

2. Start Docker services (PostgreSQL & Keycloak):

   docker compose up -d

3. Run both API and Web app:

   pnpm run dev

   This will start:

   • API server with hot reload (dotnet watch)
   • Next.js web app on http://localhost:3000

Individual Services

You can also run services individually:

• Web app only: pnpm run dev:web
• API only: pnpm run dev:api
• Worker only: pnpm run dev:worker

Initial Setup

For first-time setup, run the initialization script:

# Windows PowerShell
.\scripts\init-dev.ps1

See scripts/README.md for more details.

Project Structure

• apps/web - Next.js frontend application
• services/api - .NET Web API
• scripts/ - Development scripts

License

MIT License - see LICENSE for details.