/ docs / index.md
index.md
  1  ---
  2  hide:
  3    - navigation
  4    - toc
  5  ---
  6  
  7  <div align="center" style="margin-top: 4rem; margin-bottom: 4rem;" markdown="1">
  8  
  9  <h1 class="hero-text">Decentralized Identity for Developers</h1>
 10  
 11  <p class="hero-subtitle">
 12  Cryptographic commit signing with Git-native storage. One identity, multiple devices, no central authority.
 13  </p>
 14  
 15  [Get Started](getting-started/install.md){ .md-button .md-button--primary }
 16  &nbsp;&nbsp;
 17  [Architecture](architecture/overview.md){ .md-button }
 18  
 19  </div>
 20  
 21  ---
 22  
 23  <div class="grid cards" markdown>
 24  
 25  -   :material-git: **Git-Native, No Blockchain**
 26  
 27      ---
 28  
 29      Identity data and attestations are stored as Git refs under `refs/auths/`. Your `~/.auths` repo is the single source of truth. No database, no central server, no chain -- just Git.
 30  
 31  -   :material-devices: **Multi-Device Identity**
 32  
 33      ---
 34  
 35      Create a stable `did:keri` identity and link your laptop, phone, and CI server via signed attestations. Every device signs as **you**. Revoke a lost device in one command.
 36  
 37  -   :material-check-decagram: **Verifiable Everywhere**
 38  
 39      ---
 40  
 41      Embed `auths-verifier` via WASM, FFI, or native Rust. Verify attestation chains in browsers, CI pipelines, and backend services -- no network call required.
 42  
 43  </div>
 44  
 45  ---
 46  
 47  ## Install
 48  
 49  ```bash
 50  cargo install auths-cli
 51  ```
 52  
 53  This installs three binaries: `auths` (main CLI), `auths-sign` (Git signing program), and `auths-verify` (verification tool).
 54  
 55  !!! tip
 56      See the full [Installation guide](getting-started/install.md) for platform-specific keychain setup and pre-built binaries.
 57  
 58  ## Quick Tour
 59  
 60  ```bash
 61  # Create your cryptographic identity
 62  auths init
 63  
 64  # Sign a commit (after configuring Git)
 65  auths sign
 66  
 67  # Verify a signed commit or attestation
 68  auths verify
 69  ```
 70  
 71  ---
 72  
 73  ## Quick Links
 74  
 75  <div class="grid cards" markdown>
 76  
 77  -   :material-rocket-launch: **Getting Started**
 78  
 79      ---
 80  
 81      Install Auths, create your first identity, and sign your first commit.
 82  
 83      [Installation](getting-started/install.md)
 84  
 85  -   :material-sitemap: **Architecture**
 86  
 87      ---
 88  
 89      Understand the identity model, Git storage layout, attestation format, and crate structure.
 90  
 91      [Architecture Overview](architecture/overview.md)
 92  
 93  </div>
 94  
 95  ---
 96  
 97  ## Open Source
 98  
 99  Auths is open source under the MIT / Apache 2.0 license.
100  
101  [View on GitHub :material-github:](https://github.com/auths-dev/auths){ .md-button }