data-first

Data-First Example

What This Teaches

Use this when you have fixture data before you have a contract. db infers collections, singleton documents, REST routes, GraphQL fields, and TypeScript types from plain JSON.

Files To Inspect

• db/users.json: collection inferred from an array.
• db/posts.json: second inferred collection.
• db/settings.json: singleton document inferred from an object.

Run It

From the repository root, use the repo-internal CLI path:

npm run db -- sync --cwd ./examples/data-first
npm run db -- serve --cwd ./examples/data-first

Open the viewer:

http://127.0.0.1:7331/__db

Expected Result

sync infers schema and writes generated runtime state under examples/data-first/.db/.

REST Request To Try

Leave serve running and run this from another terminal:

curl 'http://127.0.0.1:7331/db/users.json?select=id,name,email'

Features To Notice

• Data-first JSON fixtures
• Fixture-like .json REST routes
• REST query parameters
• Runtime state

Cleanup

Generated .db/ output is ignored by git and can be removed whenever you want a fresh mirror.

More Docs

• Concepts
• Fixtures And Schemas