RoboSystems App

Version 1.1 — Production-ready platform for financial knowledge graph management

RoboSystems App is the web interface for the RoboSystems financial knowledge graph platform, providing tools to create, manage, and query graph databases.

• Graph Database Management: Create and manage multiple isolated graph databases with tiered infrastructure
• Interactive Query Console: Execute Cypher queries with Monaco editor, syntax highlighting, and streaming results
• Schema Explorer: Inspect node labels, relationships, constraints, and indexes
• Subgraph Workspaces: Create isolated environments for development, testing, and collaboration
• Shared Repository Access: Subscribe to and query SEC XBRL filings and public financial data
• Credit & Usage Tracking: Monitor AI operation credits and storage usage

Core Features

• Graph Creation Wizard: Step-by-step workflow for creating entity or generic graphs with tier selection
• Query Console: Monaco-based Cypher editor with sample queries, query history, and result streaming
• Schema Explorer: Visual inspection of node types, relationship types, properties, and indexes
• Data Lake: DuckDB staging tables for data validation and bulk ingestion
• Subgraph Management: Create, switch between, and manage isolated subgraphs (Large/XLarge tiers)
• Backup Management: View and restore graph database backups
• Repository Subscriptions: Subscribe to shared repositories (SEC XBRL) with plan selection
• Billing Dashboard: Manage subscriptions, view invoices, and track credit usage
• Organization Settings: Manage team members and organization configuration

Quick Start

npm install              # Install dependencies
cp .env.example .env     # Configure environment (edit with your API endpoint)
npm run dev              # Start development server

The application will be available at http://localhost:3000

Development Commands

Core Development

npm run dev              # Start development server (port 3000)
npm run build            # Production build

Testing

npm run test:all         # All tests and code quality checks
npm run test             # Run Vitest test suite
npm run test:coverage    # Generate coverage report

Code Quality

npm run lint             # ESLint validation
npm run lint:fix         # Auto-fix linting issues
npm run format           # Prettier code formatting
npm run format:check     # Check formatting compliance
npm run typecheck        # TypeScript type checking

SDLC Commands

npm run feature:create   # Create a feature branch
npm run pr:create        # Create pull request
npm run release:create   # Create GitHub release
npm run deploy:staging   # Deploy to staging environment
npm run deploy:prod      # Deploy to production

Core Subtree Management

npm run core:pull        # Pull latest core subtree updates
npm run core:push        # Push core subtree changes
npm run core:add         # Add core subtree (initial setup)

Prerequisites

System Requirements

• Node.js 22+ (LTS recommended)
• npm 10+
• 4GB RAM minimum
• Modern browser (Chrome, Firefox, Safari, Edge)

Required Services

• RoboSystems API endpoint (local development or production)

Deployment Requirements

• Fork this repo (and the robosystems backend)
• AWS account with IAM Identity Center (SSO)
• Run npm run setup:bootstrap to configure OIDC and GitHub variables

See the Bootstrap Guide for complete instructions including access modes (internal, public-http, public).

Architecture

Application Layer:

• Next.js 15 App Router with React Server Components
• TypeScript 5 for type safety
• Flowbite React with Tailwind CSS for UI components
• Monaco Editor for Cypher query editing
• RoboSystems Client SDK for API communication

Key Features:

• Graph Management: Create and manage multiple isolated graph databases with tier selection (Standard, Large, XLarge)
• Query Console: Monaco-based Cypher editor with syntax highlighting, sample queries, query history, and streaming results
• Schema Explorer: Visual inspection of node types, relationship types, properties, constraints, and indexes
• Data Lake: DuckDB staging tables for data validation and bulk ingestion workflows
• Subgraph Workspaces: Create isolated environments for development, testing, and collaboration (Large/XLarge tiers)
• Backup Management: View backup history and restore points for graph databases
• Repository Subscriptions: Subscribe to shared repositories (SEC XBRL) with plan selection
• Billing & Usage: Manage subscriptions, view invoices, track credit consumption and storage usage
• Organization Settings: Manage team members, API keys, and organization configuration

Core Library (/src/lib/core/):

Shared modules maintained as a git subtree across RoboSystems frontend apps:

• Auth components (login, register, password reset)
• Session management and JWT handling
• Graph creation wizard and shared components
• Layout, forms, chat, and settings components
• User, company, graph, and credit contexts
• SSE-based background job progress tracking

Infrastructure:

• AWS App Runner with auto-scaling
• S3 + CloudFront for static asset hosting
• CloudFormation templates in /cloudformation/

CI/CD

Workflows

• prod.yml: Production deployment to robosystems.ai
• staging.yml: Staging deployment to staging.robosystems.ai
• test.yml: Automated testing on pull requests
• build.yml: Docker image building for ECR

Infrastructure

• AWS App Runner with auto-scaling
• S3 + CloudFront for static asset hosting
• CloudFormation templates in /cloudformation/

Support

• Issues
• Wiki
• Projects
• Discussions

License

Apache License 2.0 - see LICENSE for details.

Apache-2.0 © 2025 RFS LLC