floework

A human-aware SaaS productivity and team collaboration platform. floework aligns individual focus with team outcomes by integrating task execution, real-time collaboration, and actionable analytics—without invasive monitoring.

Key Features

• FlowBoard: Advanced Kanban board with dnd-kit drag-and-drop support and real-time state synchronization via Supabase.
• Sprint Management: Robust project scoping with automated sprint naming, custom name overrides, and backlog integration.
• AI Execution Narrative: Intelligent executive summaries powered by Gemini 1.5 Flash, with a specialized caching layer for high-performance dashboard insights.
• Focus Engine: Deep focus session tracking with effort analysis and real-time "In Focus" team presence indicators.
• Analytics & Export:
  • Focus Distribution: Visual breakdown of task statuses using Recharts.
  • Data Portability: Integrated Excel (CSV) export and Calendar (ICS) sync for all activities and analytics.
• Premium UX: Modern glassmorphism design with orchestrated reveal animations and a deterministic avatar system.

Tech Stack

• Frontend: React (Vite), Redux Toolkit (RTK Query), Tailwind CSS, Framer-inspired Reveal system.
• Backend: Vercel Serverless Functions (Node.js/TypeScript), Google Gemini AI API.
• Database & Auth: PostgreSQL (Supabase) with Row Level Security (RLS) and Realtime subscriptions.
• Storage: Supabase Storage for secure profile asset management.

Project Structure

floework/
├── api/            # Serverless functions & backend endpoints
├── apps/web/       # Main React frontend application
├── supabase/       # Database migrations, seed data, and configuration
├── docker/         # Containerization scripts and configurations
└── docs/           # Detailed project documentation

Local Development

Prerequisites

• Node.js (v18+)
• npm or pnpm
• Supabase CLI

Setup Instructions

1. Install dependencies:

   npm install

2. Configure environment: Copy the example environment file and add your Supabase credentials:

   cp .env.example .env.local

3. Start local database:

   supabase start

4. Run development server:

   For frontend only:

   cd apps/web && npm run dev

   For full stack (including AI features):

   vercel dev

   The web app will be available at http://localhost:3000 (Vercel) or http://localhost:8080 (Vite).

Database & Storage Setup

Ensure your Supabase instance is correctly configured:

1. Apply Migrations: supabase db push (or run scripts in supabase/migrations manually).
2. Storage Bucket: Create a public bucket named avatars in the Supabase Storage dashboard to enable profile picture uploads.

Deployment

The repository is configured for deployment on Vercel.

vercel --prod

(Ensure Supabase migrations are applied to your production database.)