# Jolter

> Fast, reliable JavaScript runtime and toolchain management for local development and CI.

## Docs

- [CI automation](https://docs.jolter.dev/automation/ci.md): Use Jolter in automation with stable logs, exact outputs, and reusable caches.
- [GitHub Actions](https://docs.jolter.dev/automation/github-actions.md): Install Jolter, cache provider artifacts, and expose shims to GitHub Actions jobs.
- [GitLab CI](https://docs.jolter.dev/automation/gitlab-ci.md): Run Jolter in GitLab CI with stable storage and cache paths.
- [JSON output](https://docs.jolter.dev/automation/json-output.md): Parse Jolter machine output for inventory, diagnostics, plugins, and CI setup.
- [Offline CI](https://docs.jolter.dev/automation/offline-ci.md): Prepare caches so Jolter can synchronize projects without network access.
- [setup-jolter action](https://docs.jolter.dev/automation/setup-jolter-action.md): Plan for the future `jolterjs/setup-jolter@v1` GitHub Action.
- [First project](https://docs.jolter.dev/first-project.md): Prepare a repository so every developer and CI job resolves the same toolchain.
- [Automatic switching](https://docs.jolter.dev/guides/automatic-switching.md): Use Jolter shims to switch toolchains without shell hooks or manual version changes.
- [Monorepos](https://docs.jolter.dev/guides/monorepos.md): Place Jolter configuration so nested packages resolve the intended toolchain.
- [Project pinning](https://docs.jolter.dev/guides/project-pinning.md): Design a version policy for applications, libraries, CI jobs, and release images.
- [Runtimes](https://docs.jolter.dev/guides/runtimes.md): Install, activate, pin, and update Node.js, Bun, and Deno with Jolter.
- [Team onboarding](https://docs.jolter.dev/guides/team-onboarding.md): Roll Jolter out across a repository without surprising contributors.
- [Tools](https://docs.jolter.dev/guides/tools.md): Use npm, pnpm, Yarn, and plugin-provided tools through Jolter.
- [Updating toolchains](https://docs.jolter.dev/guides/updating-toolchains.md): Update active versions, change project policy, and safely remove old installations.
- [Jolter](https://docs.jolter.dev/index.md): One fast, reliable home for your JavaScript runtimes and tools.
- [Installation](https://docs.jolter.dev/installation.md): Install Jolter with the public scripts, verified release archives, or a source build.
- [Architecture](https://docs.jolter.dev/maintainers/architecture.md): How Jolter's Rust workspace separates CLI, config, resolution, installation, plugins, shims, diagnostics, and storage.
- [Development](https://docs.jolter.dev/maintainers/development.md): Set up the Jolter repository, run quality gates, test changes, and update docs.
- [Release operations](https://docs.jolter.dev/maintainers/releasing.md): Prepare, tag, verify, publish, smoke test, and roll back Jolter releases.
- [Mental model](https://docs.jolter.dev/mental-model.md): Understand how Jolter resolves projects, installs toolchains, and dispatches commands.
- [Diagnostics](https://docs.jolter.dev/operations/diagnostics.md): Use `jolter list` and `jolter doctor` to inspect storage, project resolution, shims, plugins, and environment health.
- [Lifecycle operations](https://docs.jolter.dev/operations/lifecycle.md): Repair, uninstall, prune, clean cache, back up, and move Jolter storage.
- [Networking and offline mode](https://docs.jolter.dev/operations/networking-and-offline.md): Configure providers, proxies, certificates, retries, cache behavior, and offline operation.
- [Troubleshooting](https://docs.jolter.dev/operations/troubleshooting.md): Fix the most common Jolter setup, PATH, project, cache, plugin, proxy, and permission problems.
- [Build a plugin](https://docs.jolter.dev/plugins/build-a-plugin.md): Create, test, validate, and package a Jolter plugin with `@jolter/jdt`.
- [Plugins overview](https://docs.jolter.dev/plugins/overview.md): Discover, install, and publish registry-backed Jolter tool providers.
- [Plugin API reference](https://docs.jolter.dev/plugins/plugin-api-reference.md): Reference for plugin names, manifests, JDT commands, exported functions, and registry release automation.
- [Plugin security](https://docs.jolter.dev/plugins/plugin-security.md): Understand Jolter's plugin trust boundaries, registry checks, and review practices.
- [Project plugins](https://docs.jolter.dev/plugins/project-plugins.md): Declare plugin providers and plugin-provided tools in `jolter.json` schema v2.
- [Publish a plugin](https://docs.jolter.dev/plugins/publish-a-plugin.md): Add a plugin repository to the Jolter registry and register GitHub releases.
- [Using plugins](https://docs.jolter.dev/plugins/using-plugins.md): Find, install, update, uninstall, and use tools provided by Jolter plugins.
- [Quickstart](https://docs.jolter.dev/quickstart.md): Install Jolter, select Node.js and pnpm, pin a project, and verify the result.
- [Command reference](https://docs.jolter.dev/reference/commands.md): Complete reference for Jolter commands, global options, aliases, and output behavior.
- [Compatibility](https://docs.jolter.dev/reference/compatibility.md): Compatibility expectations for Jolter's pre-1.0 command surface, schema, storage, and machine output.
- [Configuration](https://docs.jolter.dev/reference/configuration.md): Reference for `jolter.json` schema v2, runtimes, tools, plugins, and legacy compatibility.
- [Environment variables](https://docs.jolter.dev/reference/environment.md): Public Jolter controls, CI variables, networking variables, and internal child-process state.
- [Selectors](https://docs.jolter.dev/reference/selectors.md): Version selector grammar for runtimes, built-in tools, plugin tools, and plugins.
- [Storage](https://docs.jolter.dev/reference/storage.md): Reference for `JOLTER_HOME`, installed versions, cache, shims, plugins, and active selections.
- [Security model](https://docs.jolter.dev/security/model.md): Trust boundaries, transport, integrity, archive extraction, plugins, cache, and telemetry.
- [Report a vulnerability](https://docs.jolter.dev/security/reporting.md): How to privately report Jolter security issues and what information to include.

## Optional

- [GitHub](https://github.com/jolterjs/jolter)