Fylo Support Intelligence 📂🤖

An AI-driven ticket management and routing system built for high-performance support teams.

---

🚀 Demo

---

📖 About

Fylo is a modern, full-stack support operations platform that leverages artificial intelligence to streamline ticket ingestion, classification, and resolution. Built with a focus on speed and scalability, it automates the heavy lifting of triage so support teams can focus on high-impact customer interactions.

This project showcases a robust monorepo architecture, integrating real-time backend functions with a highly responsive frontend, all powered by a cutting-edge AI stack.

---

🛠️ Tech Stack

• Frontend: Next.js (App Router), React 19, Tailwind CSS v4, Framer Motion, Shadcn UI
• Backend: Convex (Real-time database & serverless functions)
• Authentication: Better Auth
• AI/ML: Google Gemini (Classification, Draft Generation, Resume Parsing)
• Infrastructure: Turborepo, Bun
• Communication: Resend (Email Infrastructure)
• Testing: Vitest, Playwright (E2E)

---

✨ Features

• 🧠 AI-Powered Triage: Automatically classifies and routes incoming tickets based on sentiment, priority, and intent.
• ⚡ Intelligent Drafts: Generates context-aware reply drafts using Gemini to accelerate response times.
• 📄 Resume Parsing: Extracts key agent skills and experience from resumes to optimize team assignments.
• 🕒 Real-time Queue: A live-updating ticket dashboard that reflects routing state and workload distribution instantly.
• 🛡️ Multi-tier Workflow: Structured review and visibility layers for managers to ensure quality and balance across the team.

---

🚦 Getting Started

✅ Prerequisites

• Bun 1.3.9
• Node.js 22+
• A Convex account

💻 Installation

1. Install dependencies:

   bun install

2. Initialize Convex and database:

   bun run dev:setup

⚡ Usage

To start the full development environment:

bun run dev

The app will be available at http://localhost:3001.

---

Detailed Setup & Technical Documentation

⚙️ Detailed Setup

1. Root/shared env (.env.local)

Create .env.local in the repository root:

BETTER_AUTH_SECRET=<generate-a-long-random-secret>
BETTER_AUTH_URL=http://localhost:3001
SITE_URL=http://localhost:3001

2. Web env (apps/web/.env.local)

Create apps/web/.env.local:

NEXT_PUBLIC_SITE_URL=http://localhost:3001
NEXT_PUBLIC_CONVEX_URL=https://<your-deployment>.convex.cloud
NEXT_PUBLIC_CONVEX_SITE_URL=https://<your-deployment>.convex.site

3. Backend env (Convex deployment)

After running bun run dev:setup, set these on your Convex deployment:

bunx convex env set SITE_URL http://localhost:3001
bunx convex env set BETTER_AUTH_URL http://localhost:3001
bunx convex env set BETTER_AUTH_SECRET <generate-a-long-random-secret>
bunx convex env set AI_PROVIDER_API_KEY <your-google-ai-api-key>

🧪 Tests and Verification

Unit Tests

bun run test

E2E Tests (Playwright)

bunx playwright install --with-deps chromium
bunx playwright test

🏗️ Project Structure

.
├── apps/
│   └── web/                # Next.js app
├── packages/
│   ├── backend/            # Convex functions, schema, auth integration
│   ├── config/             # Shared TS configs
│   └── env/                # Web env validation
├── .env.example            # Env variable checklist
└── docs/                   # Extended documentation

---

📜 License

This project is licensed under the MIT License.