# Turbo JS — documentation

Turbo JS is a Turbo C-style editor for JavaScript on Node.js: a full-screen terminal IDE with menus, movable windows, syntax colouring for nine languages, themes, completion from `typescript-language-server`, shell windows, per-project settings, a project tree, snippets, windows onto coding agents, and the Node toolchain a menu away.

This documentation follows the [Diátaxis](https://diataxis.fr) method. Four kinds of page, four different needs — go to the one that matches what you want right now.

| I want to… | Go to |
| --- | --- |
| **learn** the editor by using it | [Tutorials](tutorials/) |
| **do** something specific | [How-to guides](how-to/) |
| **look up** an exact detail | [Reference](reference/) |
| **understand** how and why it works | [Explanation](explanation/) |

## Tutorials — learning by doing

- [Your first Node program in Turbo JS](tutorials/getting-started.md) — install it, write a program, run it, break it and see the editor say where.
- [Demo project](../../demos/) — a small Node program to open in the editor once you have it, with a test beside it.

## How-to guides — recipes for a task

- [How to install and build Turbo JS](how-to/install.md)
- [How to install Node.js](how-to/install-node.md)
- [How to run the tests](how-to/run-the-tests.md)
- [How to enable JavaScript completion](how-to/enable-completion.md)
- [How to write your own theme](how-to/write-a-theme.md)
- [How to move around a file](how-to/navigate-code.md)
- [How to ask what the code means](how-to/ask-about-code.md)
- [How to run shell commands without leaving the editor](how-to/use-a-terminal.md)
- [How to give a project its own settings](how-to/configure-a-project.md)
- [How to browse a project and open files from a tree](how-to/browse-a-project.md)
- [How to insert snippets from a menu](how-to/use-snippets.md)
- [How to run Node commands from the editor](how-to/run-node-commands.md)
- [How to make a release](how-to/make-a-release.md)
- [How to talk to a coding agent from the editor](how-to/talk-to-an-agent.md)

## Reference — the exact details

- [Command line](reference/cli.md)
- [Keyboard](reference/keyboard.md)
- [Menus](reference/menus.md)
- [Theme file format](reference/themes.md)
- [Terminal windows](reference/terminal.md)
- [Project settings](reference/project-settings.md)
- [Project tree](reference/project-tree.md)
- [Languages coloured](reference/languages.md)
- [Snippets](reference/snippets.md)
- [JavaScript tools](reference/javascript-tools.md)
- [The version number](reference/versioning.md)
- [Agents and ACP](reference/acp.md)

## Explanation — understanding

- [Architecture](explanation/architecture.md)
- [Design decisions](explanation/design-decisions.md)
- [Colouring and completion](explanation/colouring-and-completion.md)
- [Terminal windows](explanation/terminal-windows.md)
- [Project settings](explanation/project-settings.md)
- [Project tree](explanation/project-tree.md)
- [Snippets](explanation/snippets.md)
- [JavaScript tools](explanation/javascript-tools.md)
- [Agent windows](explanation/agent-windows.md)