> ## Documentation Index
> Fetch the complete documentation index at: https://natureloved-staxiq-48.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Staxiq

> One Dashboard. Every Stacks Protocol. AI That Actually Knows What to Do with Your Bitcoin.

# Welcome to Staxiq

Staxiq is an AI-powered Bitcoin DeFi aggregator built natively on the Stacks blockchain. It gives STX and sBTC holders a single dashboard to track all their DeFi positions, compare protocol yields, assess portfolio risk, and receive personalized AI-generated strategies all anchored on Bitcoin via Stacks smart contracts.

<Note>
  **100% Non-Custodial** - Staxiq only reads your on-chain data. Your keys stay with you, your funds stay in your wallet. We never ask for private keys.
</Note>

## What is Staxiq?

Staxiq connects to your Stacks wallet and shows you exactly where your STX and sBTC are working across every Bitcoin DeFi protocol — stacking, lending, trading, earning — all on one screen. With AI-powered strategy recommendations, you can maximize your yield securely while maintaining full control of your assets.

<CardGroup cols={2}>
  <Card icon="chart-line" title="Portfolio Overview">
    Real-time tracking of STX and sBTC balances with live price feeds and portfolio valuations across all protocols.
  </Card>

  <Card icon="robot" title="AI DeFi Copilot">
    Get personalized strategy recommendations powered by Gemini AI based on your actual wallet balance and risk tolerance.
  </Card>

  <Card icon="calculator" title="Yield Calculator">
    Simulate compound returns across top Stacks DeFi protocols including ALEX, Zest, Hermetica, and StackingDAO.
  </Card>

  <Card icon="layer-group" title="Stacking Tracker">
    Manage your STX stacking positions, track rewards, monitor cycles, and view historical earnings in BTC and STX.
  </Card>

  <Card icon="scale-balanced" title="Protocol Comparison">
    Deep-dive analytics into APY, TVL, and risk profiles across all major Stacks DeFi protocols.
  </Card>

  <Card icon="heart-pulse" title="Wallet Health Score">
    Proprietary algorithm analyzes portfolio diversification, risk exposure, and provides actionable optimization tips.
  </Card>
</CardGroup>

## Key Features

### Real-Time Portfolio Tracking

View your complete Bitcoin DeFi portfolio at a glance with live updates:

* **STX Balance** - Total Stacks tokens across all protocols
* **sBTC Balance** - Synthetic Bitcoin holdings and deployments
* **Total USD Value** - Real-time portfolio valuation
* **Transaction History** - Complete on-chain activity log

### Smart Protocol Detection

Staxiq automatically detects your active positions across major protocols:

* StackingDAO (Liquid Stacking)
* Zest Protocol (sBTC Lending)
* ALEX Lab (DEX & Yield Farming)
* Bitflow (Swaps & Liquidity)
* Hermetica (Structured Products)

### AI-Powered Strategies

Get personalized DeFi strategies that analyze:

* Your current portfolio composition
* Risk-adjusted yield opportunities
* Optimal allocation recommendations
* Step-by-step execution instructions
* Risk monitoring guidelines

### Demo Mode

<Card icon="gamepad" title="Try Before You Connect">
  Experience Staxiq without connecting your wallet. Demo mode provides a complete preview with sample portfolio data so you can explore all features risk-free.
</Card>

## Platform Stats

<CardGroup cols={4}>
  <Card>
    **\$1.2B+**

    Ecosystem TVL
  </Card>

  <Card>
    **7**

    Live Protocols
  </Card>

  <Card>
    **0%**

    Platform Fees
  </Card>

  <Card>
    **Bitcoin L2**

    Stacks Network
  </Card>
</CardGroup>

## Technology Stack

Staxiq is built with modern web technologies and blockchain infrastructure:

* **Frontend**: Vite + React + Tailwind CSS
* **Blockchain Interface**: @stacks/connect, @stacks/transactions
* **Data Visualization**: Recharts
* **API Layer**: Express (Blockchain data proxy)
* **AI Engine**: Gemini AI for strategy generation

## Security Principles

<Warning>
  Staxiq is **completely non-custodial**. All transactions are signed locally via your wallet provider (Leather or Xverse). We never have access to your private keys or funds.
</Warning>

Every action you take:

1. **Initiated by you** - No automatic transactions
2. **Signed in your wallet** - Full control over approvals
3. **Transparent on-chain** - Verifiable on Stacks Explorer
4. **Reversible by you** - Withdraw anytime from protocols

## Network Support

* ✅ **Stacks Testnet** (Currently Live)
* 🔜 **Stacks Mainnet** (Alpha Launch Q2 2026)
* 🔜 **sBTC Bridge Integration**

## Get Started

Ready to optimize your Bitcoin DeFi strategy?

<Card icon="rocket" href="/quickstart" title="Quickstart Guide">
  Get from zero to your first portfolio view in under 2 minutes. Learn how to connect your wallet or try demo mode.
</Card>

## Learn More

<CardGroup cols={2}>
  <Card icon="wallet" href="/wallet-setup" title="Wallet Setup">
    Detailed guide for installing and connecting Leather or Xverse wallet to Staxiq.
  </Card>

  <Card icon="github" href="https://github.com/natureloved/Staxiq" title="GitHub Repository">
    View the source code, report issues, or contribute to the project.
  </Card>
</CardGroup>