Axiom Trade Pulse Replication (Full-Stack & Real-Time)

A high-fidelity, high-performance replication of the Axiom Trade Pulse Token Table, upgraded with a Rust Compute Bridge, WebSocket Real-Time Synchronization, and production-ready Docker Deployments.

🌐 Live Demo & Deployment Architecture

🚀 View the Live Application: crypto-trading-platform-3edc.vercel.app

🏗️ Architecture Split

This application utilizes a true dual-tier architecture:

• Vercel Deployment (Frontend Only): The live demo hosted on Vercel showcases the React/Next.js User Interface. Because serverless environments do not support persistent WebSockets or native binary execution, the UI is engineered to gracefully fall back to simulated mock data when the backend is unreachable.
• Local & Containerized (Full Stack): To experience the Sub-100ms Real-Time Engine, the application must be run locally or via Docker. In this environment, the Node.js WebSocket server spins up perfectly, automatically compiling and spawning the Rust Compute Node for zero-latency data ingestion.

🚀 Key Features

• Sub-100ms Real-Time Data: Replaces mock data with a live Socket.IO connection pushing delta-diff updates directly to the frontend.
• Rust Compute Bridge: A standalone compiled Rust binary deployed natively via spawn() that offloads extreme JSON parsing demands from the Node.js event loop, enabling zero-lag CPU efficiency during ingestion from DexScreener & GeckoTerminal.
• Atomic Next.js Architecture: High-speed UI utilizing Next.js 14 App Router, heavily memoized with Atomic components (React.memo, useMemo, useCallback) to preserve 60fps scrolling even during websocket burst updates.
• Continuous Integration: Bundled with a strict .github/workflows/ci.yml pipeline validating Rust compilation, TypeScript types, and ESLint constraints.

🛠️ Technology Stack

1. Frontend: Next.js 14 (App Router), React, Redux Toolkit, TailwindCSS, Sonner (Toasts)
2. Backend: Node.js, Express, Socket.IO
3. Compute Node: Rust 1.80+, serde_json
4. DevOps: Docker Multi-stage Builds, GitHub Actions

🚦 Local Development

You must have Node.js 20+ and Rust/Cargo installed on your system.

# 1. Install dependencies
npm ci --legacy-peer-deps

# 2. Build the Rust compute bridge
npm run build:rust

# 3. Start the dual-server environment (Websocket Backend + Next.js UI)
npm run dev:full

The application will launch with:

• Frontend Accessible at: http://localhost:3000
• Real-time API / WS Server at: http://localhost:3001
• Live Dashboard Indicator (LIVE) will pulse green upon successful connection.

📦 Production Deployment (Docker)

The repository includes a multi-stage production Dockerfile that packages the application securely and natively builds the Rust binary within a clean container.

# Build the production image
docker build -t axiom-crypto-platform:latest .

# Run the containerized platform
docker run -p 3000:3000 -p 3001:3001 axiom-crypto-platform:latest

Architectural Design

graph TD;
    A[Next.js Client GUI] <-->|WebSockets| B(Node.js Backend);
    B -->|spawn pipe| C{Rust Binary};
    C -->|Parse JS| B;
    B <-->|Poll DexScreener| D[(External DEX APIs)];

Loading

State Management

• Redux Toolkit: Maintains complex global client state (Sorting, Modals, Local preferences).
• Socket.IO Client: Replaces polling intervals handling rapid UI mutations for token prices without exhausting HTTP connections.