# Kaury

> Kaury is an open-source programming language (MIT) that compiles a single .kaury file into a complete, fast website: logic, structure, style and 3D in the same file. Pages are rendered on the server, score 100 on all four Lighthouse categories, and 3D (Three.js) is one line of code. Keywords are English, with French aliases.

Install: `npm install -g @kaury/cli`, then `kaury new my-site`, `kaury dev`, `kaury build`.
To write Kaury, an AI assistant should read the specification first: it is complete, short and made for that.

## Specification for AI assistants

- [kaury-ai.md](https://dev.kaury.studio/kaury-ai.md): the whole language in one file — syntax, core, web, immersion, golden rules, a complete example

## Skills for AI assistants

- [kaury-taste](https://dev.kaury.studio/skills/kaury-taste/SKILL.md): design taste for sites written in Kaury — reads the brief, sets three dials, removes what makes a generated site look generic; Kaury only

## Docs

- [Getting started](https://dev.kaury.studio/docs/getting-started.md): Install Kaury, create a project, see it live, build it and put it online — in five minutes.
- [Tutorial — a real site in 10 steps](https://dev.kaury.studio/docs/tutorial.md): Build a complete little shop site, from an empty file to a 3D hero, a cart and a contact form.
- [The language](https://dev.kaury.studio/docs/language.md): Values, reactive state, functions, conditions, loops, errors, imports and raw JavaScript — the core of Kaury.
- [Pages & elements](https://dev.kaury.studio/docs/web.md): Pages, sections, elements, styles, interactions, components, forms and responsive design.
- [Blocks, forms and templates](https://dev.kaury.studio/docs/blocks.md): Ready-made sections (Hero, Pricing, Faq, Contact…), forms that send e-mails, and the four templates of kaury new.
- [Immersion — 3D, scenes, characters](https://dev.kaury.studio/docs/immersion.md): Objects, scenes, lights, cameras, characters, motions, particles and sound. 3D in one line, Lighthouse still at 100.
- [Content — collections, blog, Markdown](https://dev.kaury.studio/docs/content.md): Read Markdown, MDX and YAML files at build time, make one page per item, write a blog.
- [SEO, GEO & performance](https://dev.kaury.studio/docs/seo-geo.md): What Kaury generates for Google and for AI assistants, and why the sites it builds score 100 for SEO on Lighthouse.

## Tutorials

- [A design system without CSS](https://dev.kaury.studio/blog/design-system-without-css.md): Named styles, states, parts and animations. This very site has zero lines of CSS. Here is how.
- [Let an AI write your Kaury site](https://dev.kaury.studio/blog/ai-writes-kaury.md): One prompt, one spec file, one compiler that explains its errors. A loop that turns Claude, ChatGPT or Cursor into a reliable web developer.
- [Your first 3D scene, without a model](https://dev.kaury.studio/blog/first-3d-scene.md): Kaury draws spheres, knots, gems and rings by itself. Add light, a camera that follows the mouse and particles in ten lines.
- [A landing page in 30 lines](https://dev.kaury.studio/blog/landing-page-in-30-lines.md): Hero, features, pricing and a contact form, server-rendered and fast by default, in one Kaury file you can read in a minute.

## More

- [Reference](https://dev.kaury.studio/reference/): every element, option, motion and function, generated from the compiler
- [Library](https://dev.kaury.studio/library/): ready-made pieces written in Kaury (buttons, headers, heroes, cards, effects, sections, footers), each with its live preview and its code
- [Templates](https://dev.kaury.studio/templates/): whole homepages written in Kaury, one file each, to copy and adapt
- [Playground](https://dev.kaury.studio/playground/): write Kaury, see the site, nothing to install
- [Source code](https://github.com/theoblondel/kaury-lang): compiler, runtime, CLI, VS Code extension (MIT)
- [Full text for LLMs](https://dev.kaury.studio/llms-full.txt): this index, the specification and every docs page in one file