# Lettra developer resources.

> Installation, documentation, source, and agent-readable endpoints for Lettra, a text-rendering library for Three.js.

## Start with a font and an idea.

Give your agent a font you’re allowed to use, the words, and the scene. Say how the text should move, appear, disappear or react to input.

```bash
npx skills add joyco-studio/lettra
```

```bash
pnpm add lettra three
```

Bake the font first. Lettra loads a metrics JSON and an MSDF atlas PNG, not a font file. Check the filenames, glyph coverage and kerning report.

```bash
npx lettra bake font.ttf --charset latin-es --size 64 --pxrange 8 --out public/fonts/display
```

Import from lettra/three and use the three/webgpu renderer. Load the metrics and atlas, create the text, add text.mesh to the scene, and warm it up before showing it. Check the docs for your installed version.

## Open source. MIT licensed.

MIT License, © 2026 joyco.studio. Use, modify and distribute it, commercially too, as long as you keep the copyright notice. No warranty. See the license for exact terms.

Fonts have their own licenses. Lettra’s license doesn’t let you redistribute a third-party font.

- [Lettra MIT License](https://github.com/joyco-studio/lettra/blob/main/LICENSE): The license file in the repo.

## Documentation and source

- [Lettra documentation](https://lettra-landing.vercel.app/docs): Reference, examples and font workflow.
- [Lettra source and README](https://github.com/joyco-studio/lettra): Source, install and current API.
- [Lettra agent skill](https://github.com/joyco-studio/lettra): Install the Lettra skill in your agent.
- [JOYCO experiments](https://hub.joyco.studio/lab?tag=lettra): More work from the studio.

## Read this website programmatically

HTML pages answer GET and HEAD. Accept: text/markdown returns Markdown, text/html returns HTML; q-values are honored. Unsupported types get 406, missing Markdown gets 404. Responses vary by Accept. No auth needed.

```bash
curl -i -H 'Accept: text/markdown' https://lettra-landing.vercel.app/
curl -i -H 'Accept: text/html' https://lettra-landing.vercel.app/ai
```

- [llms.txt](https://lettra-landing.vercel.app/llms.txt): Summary, usage and doc links.
- [Sitemap](https://lettra-landing.vercel.app/sitemap.xml): HTML pages and revision dates.
- [Agent guide as Markdown](https://lettra-landing.vercel.app/ai.md): Stable Markdown URL.

Lettra runs in your app. This site has no hosted API or MCP server.
