Skip to content

hugodemenez/deltalytix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Deltalytix

Deltalytix Logo

Open-source trading analytics platform for professional traders

License: CC BY-NC 4.0 Next.js React TypeScript Discord

TrustMRR verified revenue badge

πŸš€ Live Demo β€’ πŸ’¬ Discord Community β€’ πŸ› Report Bug


✨ Key Features

Dashboard overview GIF

πŸ“Š Advanced Trading Analytics

  • Real-time PnL tracking with customizable performance metrics
  • Interactive dashboards with drag-and-drop widget layouts
  • Comprehensive trade analysis with decile statistics and pattern recognition
  • Customizable chart views supporting multiple timeframes and indicators

πŸ”— Multi-Broker Integration

  • Tradovate sync for real-time trade data synchronization
  • Rithmic sync via proprietary service integration
  • Built-in integrations for FTMO, ProjectX, ATAS, and Interactive Brokers (IBKR)
  • AI-powered file parsing for any broker format when specific integration doesn't exist yet

πŸ€– AI-Powered Insights

  • Intelligent field mapping for seamless data imports
  • Sentiment analysis of trading patterns and market conditions
  • Automated trade journal with AI-generated insights
  • Pattern recognition for identifying trading opportunities
  • Rich text editor with image resizing and table support for structured journaling

🌍 Internationalization

  • Full i18n support with English and French translations
  • Extensible translation system using next-international
  • Locale-aware formatting for dates, numbers, and currencies
  • RTL language support ready for future expansion

⚑ Modern Technology Stack

  • Next.js 15 with App Router for optimal performance
  • React 19 with latest concurrent features
  • TypeScript for type-safe development
  • Prisma ORM for database operations
  • Supabase for authentication and real-time features

πŸ› οΈ Tech Stack & Architecture

Frontend

  • Framework: Next.js 15 (App Router)
  • UI Library: React 19 with TypeScript
  • Styling: Tailwind CSS with custom design system
  • Animations: Framer Motion with performance optimizations
  • State Management: Zustand stores + React Context
  • Internationalization: next-international

Backend

  • API: Next.js API Routes + Server Actions
  • Database: PostgreSQL via Supabase
  • ORM: Prisma with type-safe queries
  • Authentication: Supabase Auth (Discord OAuth, Email)
  • Real-time: WebSocket connections for live data

External Services

  • Payments: Stripe integration with webhooks
  • AI/ML: OpenAI API for analysis and field mapping
  • Storage: Supabase Storage for file uploads
  • Broker Syncs: Tradovate API, Rithmic proprietary service
  • Platform Integrations: FTMO, ProjectX, ATAS, Interactive Brokers (IBKR)
  • Deployment: Vercel-optimized with edge functions

Development Tools

  • Package Manager: Bun (recommended) or npm
  • Linting: ESLint with Next.js config
  • Type Checking: TypeScript strict mode
  • Database Migrations: Prisma migrations

πŸ“‹ Prerequisites

Before you begin, ensure you have the following:

Required Software

  • Node.js 20+ or Bun (latest version recommended)
  • Git for version control
  • PostgreSQL database (or use Supabase free tier)

Required Accounts

  • Supabase account (free tier available)
  • Stripe account (for payment processing)
  • OpenAI API key (for AI features)
  • Discord application (for OAuth authentication)

πŸš€ Installation & Setup

Step 1: Clone and Install

git clone https://github.com/hugodemenez/deltalytix.git
cd deltalytix
npm install  # or bun install

Step 2: Environment Variables

Create a .env.local file in the root directory with the following variables:

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key

# Database
DATABASE_URL=your_postgresql_connection_string

# OpenAI
OPENAI_API_KEY=your_openai_api_key

# Stripe
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret

# Discord OAuth
DISCORD_CLIENT_ID=your_discord_client_id
DISCORD_CLIENT_SECRET=your_discord_client_secret

# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000

Step 3: Database Setup

# Generate Prisma client
npx prisma generate

# Push schema to database (for development)
npx prisma db push

# Or run migrations (for production)
npx prisma migrate dev

# Seed the database (optional)
npx prisma db seed

Step 4: Run Development Server

npm run dev
# or
bun dev

Open http://localhost:3000 to view the application.


βš™οΈ Configuration Guide

Supabase Setup

  1. Create a new Supabase project
  2. Enable Discord OAuth provider in Authentication settings
  3. Configure Row Level Security (RLS) policies
  4. Set up storage buckets for file uploads
  5. Configure real-time subscriptions for live data

Stripe Configuration

  1. Create a Stripe account and get API keys
  2. Set up webhook endpoints for payment processing
  3. Configure products and pricing plans
  4. Test webhook integration in development

Discord OAuth Setup

  1. Create a Discord application in the Discord Developer Portal
  2. Navigate to OAuth2 settings and add redirect URI: http://localhost:3000/api/auth/callback/discord
  3. Copy Client ID and Client Secret to environment variables
  4. Enable the identify and email scopes for user authentication

OpenAI Integration

  1. Get an API key from OpenAI
  2. Configure usage limits and billing
  3. Test API connectivity with the field mapping feature

πŸ“ Project Structure

deltalytix/
β”œβ”€β”€ app/                    # Next.js App Router
β”‚   β”œβ”€β”€ [locale]/          # Internationalized routes
β”‚   β”‚   β”œβ”€β”€ dashboard/     # Main dashboard pages
β”‚   β”‚   β”œβ”€β”€ admin/         # Admin panel
β”‚   β”‚   β”œβ”€β”€ business/      # Business features
β”‚   β”‚   └── (landing)/     # Marketing pages
β”‚   └── api/               # API routes
β”‚       β”œβ”€β”€ ai/           # AI-powered endpoints
β”‚       β”œβ”€β”€ auth/         # Authentication
β”‚       β”œβ”€β”€ stripe/       # Payment processing
β”‚       └── cron/         # Scheduled tasks
β”œβ”€β”€ components/            # Reusable React components
β”‚   β”œβ”€β”€ ui/               # Base UI components (Radix UI)
β”‚   β”œβ”€β”€ ai-elements/      # AI-powered components
β”‚   β”œβ”€β”€ emails/           # Email templates
β”‚   β”œβ”€β”€ tiptap/           # TipTap editor components
β”‚   └── magicui/          # Custom UI components
β”œβ”€β”€ server/               # Server-side business logic
β”œβ”€β”€ store/                # Zustand state management
β”œβ”€β”€ prisma/               # Database schema and migrations
β”œβ”€β”€ locales/              # Internationalization files (EN/FR)
β”œβ”€β”€ lib/                  # Utility functions
β”œβ”€β”€ hooks/                # Custom React hooks
β”œβ”€β”€ context/              # React Context providers
β”œβ”€β”€ docs/                 # Feature documentation
β”‚   └── JOURNAL_EDITOR.md # Journal editor feature guide
└── content/              # MDX content for updates

πŸ§‘β€πŸ’» Development Guidelines

Code Style

  • Use TypeScript strict mode
  • Follow Next.js best practices
  • Implement proper error handling
  • Write self-documenting code

Translation System

Use the useI18n hook for all user-facing text:

import { useI18n } from "@/locales/client"

const t = useI18n()

// Basic translation
<CardTitle>{t('propFirm.title')}</CardTitle>

// Translation with variables
<DialogTitle>{t('propFirm.configurator.title', { accountNumber: account.accountNumber })}</DialogTitle>

State Management

  • Use Zustand stores for client-side state
  • Use React Context for complex mutations
  • Prefer Server Actions for data mutations
  • Use API routes for public data with caching

API Design

  • API Routes: For public data that benefits from caching
  • Server Actions: For mutations and private operations
  • Real-time: Use Supabase subscriptions for live updates

🀝 Contributing

We welcome contributions to Deltalytix! Here's how you can help:

Getting Started

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes and test thoroughly
  4. Commit your changes: git commit -m 'Add amazing feature'
  5. Push to the branch: git push origin feature/amazing-feature
  6. Open a Pull Request

Development Workflow

  • Follow the existing code style and conventions
  • Add tests for new features
  • Update documentation as needed
  • Ensure all translations are included
  • Test on both desktop and mobile

Reporting Issues

  • Use GitHub Issues for bug reports
  • Include steps to reproduce
  • Provide system information
  • Add screenshots if applicable

Feature Requests

  • Use GitHub Discussions for feature ideas
  • Check existing issues before creating new ones
  • Provide detailed use cases and benefits

πŸ“„ License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).

Key Points:

  • βœ… You can use, modify, and distribute this software for non-commercial purposes
  • βœ… You must give appropriate credit and provide a link to the license
  • βœ… You can create derivative works for non-commercial use
  • ❌ You cannot use this software for commercial purposes
  • ❌ You cannot distribute this software commercially without permission

What This Means:

This license allows you to use Deltalytix for personal, educational, and non-commercial purposes. You can modify and share the code as long as you give proper attribution and don't use it commercially.

For commercial licensing options, please contact us.

Read the full license text in the LICENSE file.


πŸ†˜ Support & Community

Get Help

  • πŸ’¬ Discord Community: Join our Discord for real-time support
  • πŸ“š GitHub Discussions: Ask questions and share ideas
  • πŸ› Issue Tracker: Report bugs and request features
  • πŸ“– Documentation: Check our comprehensive guides

Stay Updated

  • ⭐ Star the repository to show your support
  • πŸ‘€ Watch for releases to get notified of updates
  • 🐦 Follow us on social media for announcements

πŸ™ Acknowledgments

Contributors

Thank you to all the contributors who help make Deltalytix better!

Open Source Projects

This project builds upon many excellent open source libraries:

Inspiration

Deltalytix was inspired by the need for better trading analytics tools in the open source community.


πŸ—ΊοΈ Roadmap

βœ… Recently Completed

  • Custom Dashboard Layout - Drag-and-drop widgets with flexible workspace customization
  • AI-Powered Data Import - Intelligent field mapping for seamless CSV processing
  • Enhanced Data Processing - Multi-platform support with encryption and accurate commission calculations
  • Automatic Rithmic Integration - Direct API connection with hourly data synchronization
  • Tradovate Synchronization - Real-time trade data sync with automated import
  • Interactive Brokers Integration - PDF statement import system for comprehensive trade data
  • AMP Integration - Connected through Rithmic sync for seamless data flow
  • Subscription Plans - Flexible pricing tiers for different trader needs

πŸ”„ Currently In Development

  • Automated Journaling System - AI-assisted trade journaling that focuses on mistakes and successes
  • Collaborative AI Assistant - Notion-style peer writer for real-time trading insights and analysis

πŸ“‹ Upcoming Features (Q2-Q3 2025)

  • Enhanced Journaling Experience - Session-based analysis with automated insights on trading patterns
  • Market Data Integration - Databento connection for real-time market insights and context
  • Advanced AI Collaboration - Direct integration of AI insights into trading workflow
  • Session Analysis Tools - Automated identification of trading mistakes and successful patterns
  • Performance Coaching - AI-powered suggestions based on historical trading behavior

πŸš€ Long-term Vision (2026+)

  • Third-Party Dashboard Licensing - Prop firms can embed Deltalytix directly into their platforms
  • Interactive Brokers API Integration - Direct sync replacing PDF imports for real-time data
  • Advanced Market Analytics - Deep market insights powered by Databento data feeds
  • White-Label Solutions - Customizable platform for trading firms and educational institutions
  • Community Features - Trader-to-trader insights and collaborative learning
  • Advanced Risk Management - Real-time alerts and automated risk monitoring
  • Portfolio Optimization Tools - Modern portfolio theory and risk-adjusted returns

🎯 Strategic Focus Areas

  • Trader-Centric Development - All features designed specifically for individual traders
  • AI-Human Collaboration - Seamless integration of AI insights into natural trading workflow
  • Automated Learning - Systems that help traders identify and learn from their patterns
  • Market Context Integration - Connecting trading performance to broader market conditions

Made with ❀️ by Hugo DEMENEZ & the Deltalytix community

GitHub β€’ Discord β€’ Website

About

Trading journal with AI agents and dashboard with statistics

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •