---
title: Welcome
description: Entry point for StackSats docs, quick navigation, and recommended learning path.
---

# StackSats Documentation

<div class="hero-block">
  <p class="hero-kicker">Strategy-first Bitcoin DCA toolkit</p>
  <h2>Build, validate, and backtest stacking sats strategies with a sealed allocation framework.</h2>
  <p>
    StackSats, developed by Hypertrial, is a Python package for strategy-first Bitcoin DCA ("stacking sats") research and execution.
    Learn more at <a href="https://www.stackingsats.org">www.stackingsats.org</a>.
  </p>
</div>

<div class="grid cards" markdown>

-   :material-rocket-launch: __Start Fast__

    ---

    New to StackSats? Use the guided onboarding path.

    [Quickstart](start/quickstart.md)

-   :material-code-braces: __Run Your First Strategy__

    ---

    Create a custom strategy and run validate/backtest/export.

    [First Strategy Run](start/first-strategy-run.md)

-   :material-notebook-outline: __Interactive Notebook Demo__

    ---

    Explore a runnable marimo notebook preview for the model example workflow.

    [Notebook Demo](start/notebook-demo.md)

-   :material-shield-check: __Know the Contract__

    ---

    Understand framework-owned invariants and user-owned hooks.

    [Framework Boundary](framework.md)

-   :material-console: __CLI and Outputs__

    ---

    Use lifecycle commands and inspect artifact conventions.

    [CLI Commands](commands.md)

-   :material-chart-line: __Model + Backtest Internals__

    ---

    Deep-dive on feature engineering, scoring, and metrics behavior.

    [Model Internals](model.md) | [Backtest System](model_backtest.md)

-   :material-file-document-check: __Validation + Release__

    ---

    Operational checklists for strategy quality and maintainers.

    [Validation Checklist](validation_checklist.md) | [Release Guide](release.md)

</div>

## What StackSats Gives You

- Deterministic, invariant-enforced allocation behavior.
- Clear separation between strategy intent and framework mechanics.
- Reproducible lifecycle workflows for validate, backtest, and export.

## Recommended Reading Path

1. [Quickstart](start/quickstart.md)
2. [Notebook Demo](start/notebook-demo.md)
3. [First Strategy Run](start/first-strategy-run.md)
4. [Framework Boundary](framework.md)
5. [Model Internals](model.md)
6. [CLI Commands](commands.md)
