Implement project structure and documentation for Fog Expedition, including .mcp.json configuration, agent guidelines in AGENTS.md, and detailed project context in PROJECT_CONTEXT.md. Update .gitignore and pnpm-workspace.yaml for new dependencies and workspace management. Introduce CI monitoring skills and scripts for enhanced CI pipeline management.
This commit is contained in:
51
TOOLCHAIN.md
Normal file
51
TOOLCHAIN.md
Normal file
@@ -0,0 +1,51 @@
|
||||
# Toolchain
|
||||
|
||||
Pinned versions and setup steps for this workspace. If you're on a new machine, install in this order.
|
||||
|
||||
## System
|
||||
|
||||
- WSL2 Ubuntu 24.04 (Noble) on Windows 11
|
||||
- Docker Desktop with WSL2 integration enabled
|
||||
|
||||
## Runtime
|
||||
|
||||
- Node.js 24.x (via nvm)
|
||||
- pnpm 10.x (`npm install -g pnpm@latest`)
|
||||
|
||||
## Workspace
|
||||
|
||||
- Nx 22.7.x
|
||||
- Angular 21.2.x
|
||||
- NestJS 11.1.x
|
||||
- TypeScript 5.9.x
|
||||
|
||||
## Test runners
|
||||
|
||||
- API: Jest 30
|
||||
- Overlay: Vitest 4 via `vitest-angular` (Angular's official Vitest integration)
|
||||
- Libraries: Vitest 4
|
||||
- E2E: Playwright 1.59 (chromium only)
|
||||
|
||||
## Local services
|
||||
|
||||
Run via `docker compose up -d postgres redis`:
|
||||
|
||||
- Postgres 16-alpine (port 5432, db `fog_expedition`, user `fog`, password `fog_dev`)
|
||||
- Redis 7-alpine (port 6379)
|
||||
- Caddy 2 (port 443, HTTPS reverse proxy to host:3000)
|
||||
|
||||
## Bootstrap on a new machine
|
||||
|
||||
```bash
|
||||
nvm install 24
|
||||
nvm use 24
|
||||
npm install -g pnpm@latest
|
||||
git clone http://pihole.home:3000/maurycy/fog.git ~/code/fog-expedition
|
||||
cd ~/code/fog-expedition
|
||||
pnpm install
|
||||
pnpm approve-builds # select all
|
||||
pnpm install
|
||||
pnpm exec playwright install --with-deps chromium
|
||||
docker compose up -d postgres redis
|
||||
pnpm exec nx run-many --target=test --all --watch=false
|
||||
```
|
||||
Reference in New Issue
Block a user