Forge Documentation
Welcome to the official documentation for Forge - a modern idea-to-execution application available as both a web app and a cross-platform desktop app.
What is Forge?
Forge helps teams track ideas, goals, and tasks with:
- Visual Mind Mapping - Organize thoughts and connect ideas visually
- Goal Tracking - Set and monitor progress on team goals
- Task Management - Kanban-style task boards with drag-and-drop
- Real-time Collaboration - Voice and video calling via LiveKit
- Team Presence - See who’s online and available
- Activity Tracking - Audit logs for all changes
Available Versions
Forge is available in two versions:
| Version | Description | Best For |
|---|---|---|
| Web App | Browser-based Next.js application | Teams needing anywhere access, quick deployment |
| Desktop App | Native Tauri application (macOS, Windows, Linux) | Users preferring native performance, offline capability |
Both versions share the same core features and can connect to the same Turso database for seamless data synchronization.
Technology Comparison
| Component | Web Version | Desktop Version |
|---|---|---|
| Frontend | Next.js 16, React 19 | React 19, Vite |
| Backend | Next.js API Routes | Rust (Tauri 2.x) |
| Database | Turso (libSQL) via Prisma | Turso (libSQL) via libsql-client |
| Authentication | NextAuth.js + Azure AD | Azure AD OAuth 2.0 + PKCE |
| Real-time | LiveKit | LiveKit |
| Styling | Tailwind CSS v4 | Tailwind CSS |
| State | Zustand + React Query | Zustand + React Query |
Quick Links
Web Application
| Section | Description |
|---|---|
| Architecture Overview | Technical architecture and system design |
| User Guide | How to use Forge web features |
| Deployment Guide | Deploying to Vercel, Docker, etc. |
| Development Guide | Setting up local development |
Desktop Application
| Section | Description |
|---|---|
| Architecture Overview | Tauri architecture and data flow |
| User Guide | Desktop-specific features and workflows |
| Deployment Guide | Building, signing, and distributing |
| Development Guide | Rust + React development setup |
Shared Features
Both versions include:
- Ideas - Capture and organize concepts with priority and status
- Goals - Track objectives with deadlines and progress
- Tasks - Kanban board with drag-and-drop
- Mind Maps - Visual connections between entities
- Comments - Collaboration on any item
- Activity Feed - Complete audit trail
- Voice/Video Calling - LiveKit-powered communication
- Microsoft Sign-in - Azure AD authentication
Platform Support
Web Version
- All modern browsers (Chrome, Firefox, Safari, Edge)
- Mobile browsers supported
Desktop Version
| Platform | Status | Notes |
|---|---|---|
| macOS (Apple Silicon) | ✅ Supported | Primary development platform |
| macOS (Intel) | ✅ Supported | Universal binary |
| Windows | ✅ Supported | x64 architecture |
| Linux | ✅ Supported | AppImage and deb packages |
Source Code
| Repository | Description |
|---|---|
| forge | Web application (Next.js) |
| forge-desktop | Desktop application (Tauri) |
| forge-docs | This documentation |
Last updated on