WIP. A little custom music server
add agents md
+26
+26
AGENTS.md
+26
AGENTS.md
···
1
+
# Agent Guidelines for Boombox
2
+
3
+
## Commands
4
+
- **Build**: `bun run build` (web), no build needed for backend
5
+
- **Dev**: `bun run dev` (root - starts all workspaces), `bun run dev` (individual workspace)
6
+
- **Test**: `bun test` (backend), `bun test <file>` (single test)
7
+
- **Format**: `bun run format` (web only)
8
+
- **DB**: `bun db:migrate`, `bun db:gen` (from root)
9
+
10
+
## Code Style
11
+
- **Tabs**: Use tabs (4-width), 120 char line length
12
+
- **Imports**: Use absolute imports, no barrel files
13
+
- **TypeScript**: Strict - no `any`, explicit types preferred
14
+
- **Effect**: Use Effect.gen syntax, proper error handling with TaggedError
15
+
- **React**: Function components, Jotai for state, shadcn/ui components
16
+
- **Naming**: camelCase for variables/functions, PascalCase for components/types
17
+
- **Error Handling**: Use Effect error handling, tagged errors for typed failures
18
+
19
+
## Framework Usage
20
+
- **Runtime**: Bun (not Node.js) - use `bun` commands, `Bun.file()`, etc.
21
+
- **Backend**: Elysia + Effect + Drizzle ORM + SQLite
22
+
- **Frontend**: Waku (React framework) + Jotai + UnoCSS + shadcn/ui
23
+
- **Database**: SQLite with Drizzle migrations
24
+
25
+
## Repository Structure
26
+
Monorepo with workspaces: `backend/`, `web/`, `shared/`. Use workspace references (`@boombox/shared`).