# tnl

> tnl gives a local HTTP app an encrypted HTTPS url. Each Git worktree gets its own url by default. Visitor TLS ends in tnl on the developer's machine.

Start with the quickstart. Read how it works for the visitor path and security for the trust boundaries. The docs links point to Markdown versions of the public pages.

## Start

- [start](/docs.md): Install tnl and publish a local app.
- [install tnl skill](/skills/install-tnl/SKILL.md): Follow a short assistant workflow for installing tnl with `tnl init`.
- [how it works](/docs/how-it-works.md): Follow a visitor from its public url to the local app.
- [security](/docs/security.md): Encryption, visitor access, credentials, and operator trust.

## Use tnl

- [development](/docs/development.md): Develop across worktrees and set visitor IP policy.
- [publish](/docs/publish.md): Publish an app that is already running.
- [project configuration](/docs/configuration.md): Configure services and project defaults.
- [frameworks](/docs/frameworks.md): Connect a framework or API server to tnl dev.
- [vite](/docs/vite.md): Vite integration.
- [next.js](/docs/next.md): Next.js integration.
- [teams](/docs/teams.md): Memberships, invitations, and shared public urls.
- [domains](/docs/domains.md): Managed namespaces and claimed domains.

## Operate

- [self-hosting](/docs/self-hosting.md): Deploy standalone or split tnld with PostgreSQL.
- [operations](/docs/operations.md): Readiness, maintenance, backups, and upgrades.

## Reference

- [config reference](/docs/config-reference.md): Project fields, formats, and precedence.
- [tnl commands](/docs/cli.md): Client commands, flags, and output.
- [tnld reference](/docs/tnld.md): Server roles and process settings.
- [automation](/docs/automation.md): JSON, NDJSON, and diagnostics.
- [api contracts](/docs/api.md): The five HTTP API contracts.
- [releases](/docs/releases.md): Install and verify release artifacts.

## Optional

- [landing page](/index.md): Short product overview.