🌐 Website: https://astral-loom-site.vercel.app

A toolkit ecosystem for developers building on the Stellar network — removing repeated boilerplate around wallet connection, transaction building, error handling, CLI tooling, and UI components.

Astral Loom is made up of three complementary, independently usable repositories. See our Ecosystem Architecture document for a deep dive into how they fit together.

flowchart TD
    %% Base Layer
    Stellar[Stellar Network]
    Horizon[Horizon API]
    Soroban[Soroban RPC]
    
    Stellar --- Horizon
    Stellar --- Soroban
    
    %% Official SDK
    SDK(("@stellar/stellar-sdk"))
    Horizon --> SDK
    Soroban --> SDK

    %% Astral Loom Layer
    subgraph Astral Loom Ecosystem
        Kit[astral-loom-kit<br/>Core TypeScript SDK]
        CLI[astral-loom-cli<br/>CLI Tooling]
        Widgets[astral-loom-widgets<br/>React UI Components]
    end

    SDK --> Kit
    
    %% Dependencies within the ecosystem
    Kit --> CLI
    Kit --> Widgets

    %% Wallets
    Wallets[Wallet Extensions<br/>Freighter, Albedo, xBull]
    Wallets -.->|WalletAdapter| Kit

    %% End Users
    Backend[Backend / dApp Devs] --> Kit
    Ops[DevOps / Power Users] --> CLI
    Frontend[Frontend / React Devs] --> Widgets
    
    classDef official fill:#e3f2fd,stroke:#1565c0,stroke-width:2px,color:#000
    classDef loom fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#000
    classDef users fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px,color:#000
    
    class SDK official
    class Kit,CLI,Widgets loom
    class Backend,Ops,Frontend users

Core TypeScript SDK wrapping @stellar/stellar-sdk into higher-level utilities: unified wallet adapters (Freighter, with Albedo/xBull in progress), transaction builders (payments, trustlines), human-readable error mapping, and network config presets (testnet/mainnet/futurenet).

A command-line tool for common Stellar development tasks — creating and funding testnet accounts, inspecting balances and trustlines, decoding XDR, and submitting signed transactions — without leaving the terminal.

Embeddable React components for Stellar data: balance displays, transaction history tables, QR payment-request generators, and asset/trustline badges — drop-in UI so you don't build it from scratch.

Building on Stellar today means re-implementing the same plumbing on every project: wallet adapters with no shared interface, cryptic raw Horizon errors, manual transaction construction, and UI components built from scratch per frontend. Astral Loom exists so you can adopt any one piece — or all three — and skip that boilerplate.

Each repository has its own CONTRIBUTING.md with local setup instructions. Open issues are labeled by complexity (trivial, medium, high) and tagged good first issue where appropriate — a good starting point if you're looking to contribute.

Astral Loom is under active development. All three repositories have working code, tests, and CI. See each repo's issue tracker for what's currently open.