Glossary
Terms used across the Norns docs.
| Term | Meaning |
|---|---|
.n file |
A Svelte component written as Pug (template) and Civet (script). See the .n file. |
.c file |
A Civet module; .civet is the same. |
| Civet | A TypeScript-flavoured, indentation-based language that compiles to JavaScript (civet.dev). |
| Pug | An indentation-based HTML template language (pugjs.org). |
| Feature | A bounded domain in src/lib/norns/<feature>/ with a module, repo, service, facade and schema. |
| Module | server/module.c; the function that registers a feature's bindings on the container. |
| Repo | server/repo.c; data access, the only place SQL lives. |
| Service | server/service.c; business rules. |
| Facade | server/public.c; the feature's public API, the only legal entry point from routes and other features. |
| Schema | shared/schema.c; valibot schemas shared by server and client. |
| Container | The DI container: string tokens, bind / single / override, child scopes. |
| Token | A container key, conventionally <feature>.<role>. |
| Request scope | The child container created per request and attached to event.locals.container. |
| Page wrappers | page.load and page.actions, for +page.server.c. |
route() |
The wrapper for +server.c handlers. |
| Serializer | The hook that turns route() results into a Response; tronSerializer() is the shipped one. |
| TRON | The token-efficient wire format implemented by norns-tron. |
| Auto-import | Resolving helpers, components, presets and exports by name without import lines. |
| Preset | A UI library's components map for the auto-importer, e.g. presetUI(). |
| Atom | A CSS-only class from norns-ui (.btn, .card, ...). |
| Snippet | A Svelte 5 {#snippet}; written as +snippet('name') in Pug. |
| Migration | A forward-only SQL file under migrations/<feature>/. |
| Vetted subset | The Civet and Pug constructs the norns-core tests guarantee. |
| Verification order | norns lint, then norns check, then bun run build, then curl through the dev server. See verification workflow. |