https://github.com/robofinsystems/robosystems-app
RoboSystems App is the web interface for the RoboSystems financial knowledge graph platform, providing tools to create, manage, and query graph databases. Next.js 15+ with complete AWS infrastructure and GitHub Actions CI/CD—fork and deploy to your own AWS account.
https://github.com/robofinsystems/robosystems-app
aws cloudformation financial-data flowbite flowbite-react github-actions graph-api knowledge-graph nextjs robosystems typescript
Last synced: 11 days ago
JSON representation
RoboSystems App is the web interface for the RoboSystems financial knowledge graph platform, providing tools to create, manage, and query graph databases. Next.js 15+ with complete AWS infrastructure and GitHub Actions CI/CD—fork and deploy to your own AWS account.
- Host: GitHub
- URL: https://github.com/robofinsystems/robosystems-app
- Owner: RoboFinSystems
- License: apache-2.0
- Created: 2025-08-10T20:38:32.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-14T06:59:06.000Z (28 days ago)
- Last Synced: 2026-01-14T07:08:36.491Z (28 days ago)
- Topics: aws, cloudformation, financial-data, flowbite, flowbite-react, github-actions, graph-api, knowledge-graph, nextjs, robosystems, typescript
- Language: TypeScript
- Homepage: https://robosystems.ai
- Size: 11.5 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```bash
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
```bash
npm run dev # Start development server (port 3000)
npm run build # Production build
```
### Testing
```bash
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
```bash
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
```bash
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
```bash
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](https://github.com/RoboFinSystems/robosystems) backend)
- AWS account with IAM Identity Center (SSO)
- Run `npm run setup:bootstrap` to configure OIDC and GitHub variables
See the **[Bootstrap Guide](https://github.com/RoboFinSystems/robosystems/wiki/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](https://github.com/RoboFinSystems/robosystems-app/issues)
- [Wiki](https://github.com/RoboFinSystems/robosystems/wiki)
- [Projects](https://github.com/orgs/RoboFinSystems/projects)
- [Discussions](https://github.com/orgs/RoboFinSystems/discussions)
## License
Apache License 2.0 - see [LICENSE](LICENSE) for details.
Apache-2.0 © 2025 RFS LLC