first commit

README.md

@@ -0,0 +1,36 @@
+# Fog Expedition Monorepo
+
+Nx-style monorepo scaffolding for:
+
+- `apps/twitch-extension-panel` (Angular viewer panel)
+- `apps/broadcaster-config` (Angular broadcaster config view)
+- `apps/api` (NestJS EBS API + tick engine)
+- `libs/api-interfaces` (shared contracts)
+- `libs/mission-logic` (encounter resolver + simulator CLI)
+- `libs/encounter-library` (encounter content + schema validation)
+
+## Quick start
+
+1. Install Node.js 20+
+2. Run `npm install`
+3. Copy `.env.example` to `.env` and fill values
+4. Start infra with `docker compose up -d postgres redis`
+5. Run `npm run start:api` and `npm run start:panel`
+
+## Useful commands
+
+- `npm run start:local-dev` - starts panel with Twitch mock mode enabled
+- `npm run simulate` - runs mission balance simulation
+- `nx run encounter-library:validate` - validates encounter JSON schema
+
+## Devcontainer
+
+- Reopen this folder in a devcontainer (VS Code/Cursor command: "Reopen in Container").
+- The container uses `.devcontainer/devcontainer.json` and starts:
+  - `workspace` service (Node 20)
+  - `postgres`
+  - `redis`
+- Dependencies are installed automatically via `postCreateCommand` (`npm install`).
+- After the container starts, run:
+  - `npm run start:api`
+  - `npm run start:panel`