Skip to content

AGENTS.md

Latest commit

 

History

History
54 lines (40 loc) · 1.49 KB

AGENTS.md

File metadata and controls

54 lines (40 loc) · 1.49 KB
Raw

Lakebed App Instructions

This is a Lakebed capsule. Build the app inside this directory using the Lakebed v0 contract.

File Layout

  • server/index.ts: schema, queries, and mutations.
  • client/index.tsx: Preact UI entrypoint.
  • shared/: pure TypeScript shared by client and server.

Commands

Run locally:

lakebed dev

Deploy:

lakebed deploy

Inspect local state while lakebed dev is running:

lakebed db list --port 3000
lakebed db dump --port 3000
lakebed logs --port 3000

Rules

  • Use lakebed/server only from server/index.ts.
  • Use lakebed/client only from client/index.tsx.
  • Do not import npm packages from app code.
  • Do not use Node built-ins in app code.
  • Use Tailwind classes directly in JSX.
  • Do not add a CSS, PostCSS, or Tailwind build pipeline.
  • Use auth through ctx.auth on the server and useAuth() on the client.
  • Read server-only environment variables through ctx.env; define them in .env.lakebed.server.
  • Add Google sign-in with <SignInWithGoogle /> or signInWithGoogle() from lakebed/client.
  • Keep shared/ free of DOM, Node, env, and Lakebed runtime imports.

Current Limits

  • One server entry.
  • One client entry.
  • Guest auth locally, with built-in Google sign-in through Shoo.
  • No file storage.
  • No outbound fetch in anonymous deploys. Claim the deploy before using server-side fetch.
  • Non-empty .env.lakebed.server files sync only after a deploy is claimed.
  • Local state resets when lakebed dev restarts.