Skip to content

Repository files navigation

ar.io Console

A unified web application for uploading and accessing permanent data through the ar.io Network. Built with React 18, TypeScript, Vite, and multi-chain wallet support.

Overview

The ar.io Console provides a streamlined interface for:

  • File uploads to the permaweb with instant confirmation
  • Site deployment with ArNS domain support
  • Credit management (purchase, share, gift)
  • ArNS domain search and management

Quick Start

npm install       # Or: yarn install
npm run dev       # Start dev server at http://localhost:3000

Development Commands

Command Description
npm run dev Development server (4GB memory)
npm run build:prod Production build with type checking (8GB memory)
npm run build:staging Staging build with source maps
npm run build Development build (no type check)
npm run lint ESLint validation
npm run type-check TypeScript checking
npm run clean:all Full clean and reinstall
npm run preview Preview production build

Tech Stack

  • React 18.3 with TypeScript 5.5, Vite 5.4
  • State: Zustand (persistent + ephemeral), TanStack React Query v5
  • Wallets: Arweave (Wander), Ethereum (Wagmi/RainbowKit/Privy), Solana (wallet-adapter)
  • Payments: Stripe (fiat), native crypto, X402 protocol (Base USDC)
  • Styling: Tailwind CSS, Besley + Plus Jakarta Sans fonts
  • Key SDKs: @ardrive/turbo-sdk, @ar.io/sdk 4.0.2

Environment Variables

Create a .env file:

VITE_NODE_ENV=production              # Controls mainnet vs testnet
VITE_PRIVY_APP_ID=...                 # Required for email auth
VITE_WALLETCONNECT_PROJECT_ID=...     # Optional
VITE_SOLANA_RPC=...                   # Optional, has default

Routes

/              # Landing/Home
/topup         # Buy credits (fiat/crypto)
/upload        # File upload
/capture       # Web page capture
/deploy        # Site deployment
/deployments   # Deployment history
/share         # Share credits
/gift          # Send gift credits
/redeem        # Redeem gift code
/account       # Account overview
/domains       # ArNS domain management
/balances      # Balance checker
/calculator    # Pricing calculator
/services-calculator  # Storage + ArNS calculator
/settings      # Configuration and gateway info
/try           # Try it now (quick upload demo)

External resources are available via the navigation menu:

Wallet Capabilities

Feature Arweave Ethereum/Base Solana
Buy Credits (Fiat/Crypto)
Upload/Deploy/Capture
Share Credits
Update ArNS Records
X402 USDC Uploads ✅ (Base only)

Documentation

For detailed development guidance including architecture, hooks reference, state management patterns, and critical implementation details, see CLAUDE.md.

For styling patterns and component guidelines, see STYLE_GUIDE.md.

Links

About

The ar.io Console is your all-in-one platform for building on the permanent web — upload files, deploy sites, manage credits, and secure ArNS domains from a single dashboard. Built for developers and enterprises ready to integrate permanent data storage with transparent pricing and flexible payment options.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages