---
title: Documentation
url: "/docs/"
canonical_url: https://docs.blossom88.com/docs/
markdown_url: https://docs.blossom88.com/docs.md
summary: Blossom deploys your Apps and keeps them running, on Blossom Cloud or your
  own cloud account.
---

# Documentation

Use Blossom Cloud or connect your own cloud provider account. Both use the same
Apps, Environments, Services, Data, and operational evidence.

## Start with an App

<div class="docs-card-grid not-typography" data-columns="3">
  <a href="/learn/prompt-and-deploy/" class="docs-card">
    <h3>Prompt and Deploy</h3>
    <p>Tell your AI agent to deploy, and Blossom keeps it running.</p>
  </a>
  <a href="/learn/getting-started/" class="docs-card">
    <h3>Getting Started</h3>
    <p>Your first App on Blossom Cloud, step by step in the terminal.</p>
  </a>
  <a href="/docs/quickstarts/" class="docs-card">
    <h3>Quickstarts</h3>
    <p>A framework's defaults, in the same New App flow.</p>
  </a>
</div>

## Operate the product

<div class="docs-card-grid not-typography">
  <a href="/docs/apps/" class="docs-card">
    <h3>Apps</h3>
    <p>Environments, Services, Builds, Releases, health, and configuration.</p>
  </a>
  <a href="/docs/apps/preview-environments/" class="docs-card">
    <h3>Preview Environments</h3>
    <p>A temporary copy for each pull request or branch.</p>
  </a>
  <a href="/docs/apps/environment-access/" class="docs-card">
    <h3>Environment Access</h3>
    <p>Account members, shareable links, bypass tokens, or a password.</p>
  </a>
  <a href="/docs/data/" class="docs-card">
    <h3>Data</h3>
    <p>Databases, Caches, backups, and recovery.</p>
  </a>
  <a href="/docs/domains/" class="docs-card">
    <h3>Domains</h3>
    <p>Generated endpoints, custom names, routing, and TLS.</p>
  </a>
  <a href="/docs/monitoring/" class="docs-card">
    <h3>Observe</h3>
    <p>Logs, metrics, Containers, health, and Activity.</p>
  </a>
  <a href="/docs/capacity/" class="docs-card">
    <h3>Capacity</h3>
    <p>Sizing, the capacity limit, and what Blossom charges for.</p>
  </a>
  <a href="/docs/debug/" class="docs-card">
    <h3>Troubleshooting</h3>
    <p>Start from Product health, logs, and Activity.</p>
  </a>
</div>

## Choose where Apps run

Every App runs in one [Location](/docs/locations/): a Blossom
Cloud region, or a region in your own cloud account.
[Cloud Providers](/docs/locations/cloud-providers/) explains Blossom Cloud and
Blossom BYOC (bring your own cloud), including setup, billing, credentials,
permissions, and quota.

## Reference

Use the [Blossom CLI concepts](/docs/blossom-cli/) for profiles
and defaults and the [CLI Reference](/docs/reference/cli/) for exact command
syntax.