gjermund/tessera
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update CLAUDE.md with current project state and workflow

Browse Source 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Gjermund Høsøien Wiggen
2026-06-09 10:43:34 +02:00
parent 06cc7c79a3
commit ade966ace7
1 changed files with 7 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
CLAUDE.md
View File

@@ -40,20 +40,22 @@ tessera/
```bash
cd ~/projects/tessera
cp .env.example .env # Edit DATABASE_URL to point to postgres://tessera:***@127.0.0.1:5433/tessera
bun run src/index.ts # Starts on port 9876
npm run dev:backend # Starts API on port 9876
```
### Run migrations
```bash
bun run src/db/migrate.ts
npm run db:migrate
npm run db:seed # Optional demo data for UI review
npm run db:seed:reset # Reset local app data, then recreate demo data
```
### Start frontend
```bash
cd web
npm install # Use npm, NOT bun (bun has compatibility issues with Next.js dev server)
npx next build # Production build
npx next start --port 5173 # Production server
npm run build # Production build
npm run start # Production server on 127.0.0.1:3100
```
**Note:** `bun run dev` (Turbopack) has WebSocket HMR issues in this environment. Use production mode only.
@@ -103,7 +105,7 @@ OpenCode server: `opencode serve --port 4096` (Gjermund attaches with `opencode
After OpenCode makes changes:
1. `cd web && npx next build` — verify zero errors
2. `npx next start --port 5173` — restart production server
2. `npm run start` — restart production server on 127.0.0.1:3100
3. `git push` — push to origin
## Common Issues