Introduction · Intent

Intent is a specification language. You write what should exist. The compiler derives architecture and implementation.

This repository is the language, compiler, and toolchain. It is not a notifications product, a shop product, or any other vertical. Domain names in the examples exist so the syntax is readable.

The implementation is disposable. The intent is durable.

What stays deterministic

Parsing and validation never call a model. Optional AI assistance may emit .intent source only. You still run intent validate on that source.

What you get

A language for actors, resources, types, constraints, and permissions
A CLI that can parse, validate, generate, draft, and inspect
Generated OpenAPI, SQL, APIs, and clients from a valid program. See Generate.

Start here

Install the CLI, then walk the language with examples/notifications.

On this site

Start

Introduction What Intent is, and what it is not.
Install Get the CLI from npm and run the first commands.

Language

Language Actors, resources, types, constraints, and permissions.
Examples Notifications, shop, ledger, and the rest of the tree.

Toolchain

CLI parse, validate, generate, compile, draft, inspect.
Generate What the compiler writes from a valid program.
Draft Turn a requirement into Intent, then validate it.
Packages The published @intent-lang modules.