stemlen/fairlx repository overview

⁠Fairlx

Enterprise-grade agile project management for modern teams.

Fairlx is an open source platform combining organizations, workspaces, custom workflows, AI assistance, usage-based billing, and GitHub integration — all built on Next.js 15, TypeScript, and Appwrite.

⁠✨ Features

• 5-level hierarchy — Organizations → Workspaces → Spaces → Projects → Tasks
• Dual account system — Personal accounts and Organization accounts with shared billing
• Custom workflows — Build custom status flows with AI-powered suggestions via Google Gemini
• Enterprise RBAC — Granular role-based permissions at every level
• GitHub integration — Repository linking, commit sync, auto documentation generation
• Time tracking — Estimates vs actuals, timesheets, capacity planning
• Usage-based billing — Metered traffic/storage/compute with Razorpay integration
• Real-time — Live updates via Socket.IO and Appwrite Realtime

⁠🚀 Quick Start

⁠Prerequisites

• Appwrite⁠ instance (self-hosted or cloud)
• A .env.local file — copy from .env.example⁠ and fill in your Appwrite credentials

⁠Run

docker run -p 3000:3000 --env-file .env.local stemlen/fairlx:latest

⁠Run with Docker Compose

# Clone the repo to get docker-compose.yml and .env.example
git clone https://github.com/stemlen/fairlx.git
cd fairlx
cp .env.example .env.local
# Fill in .env.local with your Appwrite credentials
docker-compose up

Open http://localhost:3000⁠

⁠🏷️ Tags

⁠🔗 Links

• GitHub: https://github.com/stemlen/fairlx⁠
• Contributing: https://github.com/stemlen/fairlx/blob/main/CONTRIBUTING.md⁠
• Documentation: https://github.com/stemlen/fairlx/blob/main/README.md⁠

⁠🛠️ Tech Stack

Next.js 15 · TypeScript · Tailwind CSS · Appwrite · Socket.IO · Google Gemini · Razorpay