Next.js dashboard — the human control plane of Astroid, the Financial Operating System for autonomous AI agents on Stellar. Built for the Drips Stellar Wave Program.
astroid-web is the interface through which organizations govern their AI agents. Humans set budgets, define spending policies, approve high-value transactions, and audit every action — the AI agents operate within those constraints on-chain.
- Agent management — create, configure, and monitor AI agents with provider/model selection (Nvidia, OpenAI, Anthropic, Gemini, Ollama, Custom)
- Wallet dashboard — Stellar wallet balances, transaction history, and XDR signing
- Policy engine UI — create spending rules and simulate them against proposed transactions
- Approval workflows — multi-party proposal review with approve/reject controls
- Budget tracking — department-level budgets with real-time consumption meters
- AI assistant — Nvidia NIM-powered chat with financial briefings and anomaly alerts
- Audit log — immutable log of every agent action and governance decision
- Developer portal — API keys and webhook management
- Live / mock mode — set
NEXT_PUBLIC_API_URLto switch from local fixtures to the live API automatically
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript (strict) |
| Styling | Vanilla CSS + CSS variables |
| Data fetching | TanStack Query v5 |
| SDK | @astroid/sdk (internal monorepo) |
| Animation | CSS transitions + custom chameleon cursor |
npm install
cp .env.local.example .env.local # set NEXT_PUBLIC_API_URL
npm run dev # http://localhost:3001No backend? Leave
NEXT_PUBLIC_API_URLempty and the app runs in mock mode — every screen renders realistic fixture data with simulated latency. No network calls are made.
| Variable | Required | Description |
|---|---|---|
NEXT_PUBLIC_API_URL |
Yes (prod) | Base URL of astroid-api, e.g. https://api.example.com |
NEXT_PUBLIC_API_VERSION |
No | API version prefix, defaults to /api/v1 |
| Script | Purpose |
|---|---|
npm run dev |
Dev server on localhost:3001 |
npm run build |
Production build |
npm run start |
Run production build |
npm run typecheck |
tsc --noEmit |
npm run lint |
ESLint |
| Repo | Description |
|---|---|
| astroid-api | NestJS backend |
| astroid-contract | Soroban smart contracts |
| astroid-sdk | TypeScript SDK and React hooks |
| Name | GitHub | Contact |
|---|---|---|
| Astroid Team | @ASTROIDX556 | Open an issue or discussion |
See CONTRIBUTING.md. PRs require passing build, typecheck, and lint.
See SECURITY.md for the responsible disclosure policy.
MIT — see LICENSE. Optimized frontend component render cycles to boost page load performance. Updated API endpoint routing configurations for seamless client communications. Enhanced inline code documentation across primary user interface modules. Corrected outdated build environment settings and package dependencies. Clarified integration test instructions for verifying frontend asset delivery. Streamlined UI state management protocols to minimize unnecessary component rerenders. Updated client-side routing structures to ensure seamless navigation across pages. Expanded inline comments within core utility scripts to aid future development. Corrected deprecated package parameters in build configuration files. Clarified testing execution commands for running end-to-end web interface suites. Standardized UI notification structures and fallback display states. Clarified local setup instructions for setting up developer environments. Standardized error messaging components and fallbacks across the web app. Enhanced security guidelines for cross-origin requests and token handling. Resolved formatting inconsistencies across project documentation files. Added step-by-step deployment instructions for hosting target environments. Updated web performance tracking parameters and diagnostic metrics. Enhanced inline comments within custom UI components for improved clarity. Corrected outdated build environment settings and package definitions. Clarified testing procedures for validating cross-browser UI compatibility. Standardized modal and banner error displays across the web application. Reinforced security policies regarding local storage usage and session timers. Resolved layout and markdown structure issues in technical project documentation. Added step-by-step instructions for publishing production web application builds Updated web performance tracking parameters and diagnostic metrics. Added step-by-step instructions for publishing production web application builds Standardized UI notification structures and fallback display states.