> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prvue.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Automated preview deployment for backend applications—isolated environments per PR on Digital Ocean

Prvue creates **isolated preview environments** for backend applications when you open GitHub pull requests. Each PR gets its own Docker containers (app + database), path-based routing via nginx, and automatic cleanup when the PR closes or after a configurable TTL—similar to how Vercel or Netlify work for frontend apps.

## What you get

* **Automatic previews**: Open a PR and get a live URL in 2–3 minutes
* **Database isolation**: Each preview has its own PostgreSQL (or MySQL/MongoDB) instance
* **Supported frameworks**: NestJS, Go, Laravel, Rust, and Python with built-in templates (or use repo-owned `docker-compose.preview.yml` for custom needs)
* **Infrastructure as Code**: Terraform provisions the droplet; Ansible configures Docker, nginx, and the orchestrator
* **CLI**: `preview init`, `preview setup`, `preview sync`, `preview status`, `preview destroy`

## Quick links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get Prvue up and running in minutes—prerequisites, tokens, and first PR.
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration">
    Repository config, CLI config, env vars, and framework options.
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/architecture">
    System design, components, data flow, and security.
  </Card>

  <Card title="Examples" icon="code" href="/examples">
    NestJS, Laravel, Go, Python, and Rust example repos and key files.
  </Card>
</CardGroup>

## Next steps

<Steps>
  <Step title="Run the Quickstart">
    Follow the [Quickstart](/quickstart) to install the CLI, get tokens, and run `preview setup`.
  </Step>

  <Step title="Add preview-config to your repo">
    Add a `preview-config.yml` (and optional `docker-compose.preview.yml`) to your repository root. See [Configuration](/configuration) and [Examples](/examples).
  </Step>

  <Step title="Open a PR">
    Create a branch, push, and open a PR. The orchestrator will build and comment with the preview URL.
  </Step>
</Steps>

<Info>
  Example backends (NestJS, Laravel, Go, Python, Rust) are documented under **Examples** with repo links and key files.
</Info>
