Skip to content

Latest commit

 

History

History
192 lines (134 loc) · 8.02 KB

Documentation.md

File metadata and controls

192 lines (134 loc) · 8.02 KB

✦ Stellar Dev Dashboard

A real-time, open-source developer dashboard for the Stellar network — built with Vite + React.

License: MIT Network: Stellar Stack: Vite + React Status: Active Stellar Wave


Overview!!

Stellar Dev Dashboard is a free, open-source web application that gives Stellar developers a unified, real-time view of accounts, transactions, smart contracts, and network activity — all in one place.

It is purpose-built for developers working on the Stellar ecosystem who need quick access to on-chain data without switching between multiple tools. Whether you're debugging a Soroban contract, checking account balances, or monitoring network fee stats, this dashboard brings it all under one roof.

This project is actively maintained and participates in the Stellar Wave Program on Drips — a monthly open-source contribution sprint where contributors can earn rewards for merged pull requests.


Features

🔑 Account & Balance Viewer

Inspect any Stellar public key in detail. View all asset balances (XLM and non-native), account flags, signing thresholds, signer list, and sequence number. Works on both Mainnet and Testnet.

⇄ Transaction & Operation History

Browse the full transaction and operation history for any account. Filter between transactions and individual operations, with details including fees, memos, timestamps, and direct links to Stellar Expert.

◻ Soroban Contract Explorer

Enter any Soroban smart contract address to inspect its on-chain ledger data, WASM hash, and persistent instance storage via the Soroban RPC. Built to support developers actively building and debugging contracts.

◎ Network Stats

Live network information including the latest ledger sequence, base fee, transaction count, operation count, fee percentile breakdowns (P10–P90), and a stream of recent ledgers.

⬡ Testnet Faucet

Fund any testnet account directly from the dashboard using Stellar's Friendbot. Activates new accounts and re-funds existing ones with 10,000 XLM. Only available on Testnet.

🔌 Wallet Connect

Connect any Stellar public key (G...) on either Mainnet or Testnet to load account data, history, and balances instantly.

🔗 Shareable View Links

Reproduce a view exactly instead of sending a screenshot. Press Share in the dashboard toolbar to get a link that captures the network, tab, selected entity, and active filters — optionally pinned to a specific ledger sequence so the data reflects that point in time. The recipient's dashboard rebuilds the view, and a banner warns them if the link's network differs from theirs. Links never contain wallet keys, session tokens, or connected-wallet data.


Screenshots

Coming soon — add screenshots of the dashboard, account view, and contract explorer here.


Getting Started

Prerequisites

  • Node.js >= 18
  • npm >= 9

Installation

# Clone the repository
git clone https://github.com/YOUR_USERNAME/stellar-dev-dashboard.git
cd stellar-dev-dashboard

# Install dependencies
npm install

# Start the development server
npm run dev

The app will be available at http://localhost:5173.

Build for Production

npm run build
npm run preview

Project Structure

stellar-dev-dashboard/
├── index.html
├── vite.config.js
├── package.json
└── src/
    ├── main.jsx                  # App entry point
    ├── App.jsx                   # Root component + layout
    ├── styles/
    │   └── globals.css           # Design system & CSS variables
    ├── lib/
    │   ├── stellar.js            # Stellar SDK wrapper (Horizon + Soroban RPC)
    │   └── store.js              # Zustand global state
    └── components/
        ├── layout/
        │   └── Sidebar.jsx       # Navigation sidebar
        └── dashboard/
            ├── ConnectPanel.jsx  # Landing / wallet connect screen
            ├── Overview.jsx      # Account summary + recent activity
            ├── Account.jsx       # Full account detail view
            ├── Transactions.jsx  # Transaction & operation history
            ├── Contracts.jsx     # Soroban contract explorer
            ├── NetworkStats.jsx  # Live ledger & fee statistics
            ├── Faucet.jsx        # Testnet Friendbot faucet
            └── Card.jsx          # Reusable UI components

Tech Stack

Tool Purpose
Vite Build tool & dev server
React 18 UI framework
@stellar/stellar-sdk Horizon API & Soroban RPC
Zustand Global state management
date-fns Date formatting
Lucide React Icon library

Contributing

This project participates in the Stellar Wave Program on Drips. Contributors who resolve issues during an active Wave earn Points that translate to real USDC rewards.

Read the Terms & Rules before contributing.

How to Contribute

  1. Fork the repository
  2. Create a branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit: git commit -m "feat: description"
  4. Push to your fork: git push origin feature/your-feature-name
  5. Open a Pull Request against main

Unit Testing & Test Runner

This project has consolidated on Vitest as the single unit and integration test runner. The legacy parallel Jest runner (jest.config.js, @types/jest, test:jest* scripts, Babel Jest presets) has been retired.

  • Run all unit & integration tests: pnpm test
  • Watch mode: pnpm run test:watch
  • Coverage report: pnpm run test:coverage
  • Unit tests only: pnpm run test:unit
  • Integration tests only: pnpm run test:integration
  • Verify coverage thresholds: pnpm run test:coverage:check

When writing tests:

  • Use standard Vitest APIs (import { describe, it, expect, vi } from 'vitest').
  • Do not use jest globals; use vi (vi.fn(), vi.spyOn(), vi.mock()).
  • All test coverage thresholds and path targets are configured centrally in vitest.config.js.

Please make sure your PR:

  • Is scoped to a single issue
  • Includes a clear description of what was changed and why
  • Does not introduce breaking changes without discussion

Roadmap

  • v0.1 — Account viewer, transaction history, Soroban explorer, network stats, faucet ✅
  • v0.2 — Real-time ledger streaming, asset prices, DEX order book
  • v0.3 — Transaction builder, contract invocation UI
  • v1.0 — Full Stellar developer toolkit with wallet signing support

License

MIT © 2025 — See LICENSE for details.


Acknowledgements

Built on top of the Stellar SDK and Horizon API by the Stellar Development Foundation.

Part of the Stellar Wave Program — funding open-source development on Stellar via Drips.

New Features (2026 Q3)

  • Transactions: Annotate counterparties with custom nicknames and risk flags in the transaction history view.
  • DEX: Visualize liquidity depth and concentration using Order Book Heatmaps for major trading pairs.
  • Analytics: Rapidly respond to detected issues using anomaly-to-action playbooks.
  • UX: Use the new guided first-run onboarding checklist for a smoother initial setup experience.