Reference
Jadpo is a programming language for web backends that AI agents write and people review. This is how every part of it works, by subject. Jadpo's CI compiles every example here. These pages come from its main branch at commit aee2e8f, version 0.3.0.
New to Jadpo? The Learn path builds one app from an empty folder.
- Standard types 259
Types every program can use, such as
Email,MoneyandPostalCode. - Commands 33
Every
jadposubcommand, such asjadpo check. - Compiler errors 744
One page for each error the compiler can report, with an example and the fix.
- Primer
The whole language on one page. Coding agents read it first.
By subject
- Language
How a Jadpo program is laid out and written: its types, logic, failures and standard library.
Project layout and modules · Values and types · Logic · Failures · Standard library
- Data
What an app stores and how it reads and writes it: entities, migrations, queries, personal data and location.
In the compiler today: ✓ 0 built · ▲ 1 partly · ○ 0 not builtEntities, stores and migrations · Reads and writes · Personal data · Geospatial
- APIs
What an app answers: its routes, who is calling them and what each caller may do.
- Background work
What runs outside a request: schedules, batches, events, and what happens when a delivery fails.
In the compiler today: ✓ 0 built · ▲ 1 partly · ○ 0 not built - Built-in services
What Jadpo gives an app without a package: email, files, flags, rate limits, search, audit, AI and more.
In the compiler today: ✓ 1 built · ▲ 7 partly · ○ 4 not builtEmail · Files · Feature flags · Rate limits · Search · Audit trail · AI · and 6 more
- External services
Another company's API from your app: connecting to it, calling it, receiving from it, and using packages.
In the compiler today: ✓ 0 built · ▲ 2 partly · ○ 1 not builtHow packages, connections, capabilities and services fit together · Connecting and calling · Receiving from outside · Capabilities · and 3 more
- Configuration
Settings and secrets, and the languages your app speaks: locales and translations.
- Testing
How your tests run your real application against a real database: kinds of test, fixtures and fakes.
Where tests live · Writing a test · Kinds of test · Test settings · and 9 more
- Tools
The jadpo command, your editor, building and deploying, and what a coding agent can look up.
In the compiler today: ✓ 0 built · ▲ 2 partly · ○ 0 not builtCommands · Formatter and editors · Building and deploying · Tools for agents · Suggestions · Debugging · Review and records
- Errors
What each error means and how to fix it.
Error messages · Declining a judgement call · Errors only the running app or a build raises · Command-line errors · and 2 more
Common jobs
Reaching outside
Shipping
For agents
Every page is also Markdown: add .md to its address. Start at /llms.txt, the site's index for agents, and read /docs/primer.md. Follow /learn.md to teach someone Jadpo. For anything else, /llms.txt lists each guide and each group of pages in this reference, and a group's page lists what's in it. Each compiler error prints a rule name, and that error's page is /docs/errors/<rule>.