fullstack-bun-sample: Instructions file for Codex

AGENTS.md

This repository is a Bun fullstack dev server + Elysia sample.

Tech stack

• Runtime/bundler: Bun (HTML imports, bun build, bun --hot)
• Server: Elysia (Bun-backed)
• Client: React 19 + TanStack Router (file-based) + Tanstack Query
• Styling: Tailwind CSS v4 + tw-animate (animation utilities)
• UI primitives: Radix UI + lucide-react (shadcn/ui-style, local component copies)

Directory tree (annotated)

Curated tree (not exhaustive) focusing on key areas:

.
├── AGENTS.md
├── README.md
├── bunfig.toml
├── build.ts
├── Dockerfile
├── cloudbuild.yaml
├── src/                 # application source
│   ├── server.ts
│   ├── server/          # Elysia app and API features
│   │   ├── app.ts
│   │   └── features/    # API modules per feature
│   │       └── <feature>/   # feature namespace
│   │           ├── routes.ts
│   │           └── service.ts
│   ├── public/          # static public assets
│   │   └── index.html
│   ├── main.tsx
│   ├── routes/          # TanStack Router file routes
│   │   └── **/*.tsx
│   ├── routeTree.gen.ts
│   ├── client/          # client-side app modules
│   │   ├── app/         # providers, router, query setup
│   │   ├── components/  # shared UI components
│   │   ├── features/    # client feature logic
│   │   ├── infra/       # client infrastructure
│   │   │   └── api/     # Eden client + helpers
│   │   └── styles/      # Tailwind source styles
│   │       └── global.css
│   └── shared/          # shared types/data
└── dist/                # build output

Project map

• src/server.ts: server entry; serves index.html for / and SPA fallback; API under /api/*.
• src/server/app.ts: Elysia app, error handling, feature route registration.
• src/server/features/**: API modules (e.g. routes.ts, service.ts).
• src/public/index.html: HTML entry (imports ../main.tsx).
• src/main.tsx: React entry; renders providers and router.
• src/routes/**: TanStack Router file routes (UI-level route components).
• src/routeTree.gen.ts: generated router tree; do not edit. Run bun run generate-root.
• src/client/app/**: Tanstack Query + Router providers and setup.
• src/client/features/**: UI logic per feature/route.
• src/client/infra/api/**: Eden client + helpers (unwrap for Tanstack Query).
• src/client/components/**: shared UI components.
• src/client/styles/global.css: Tailwind source (compiled at build time).
• src/shared/**: shared types/data for server + client.
• dist/: build output (index.html, index-*.js, index-*.css, server.js).