The Operating System for
Flawless Events.

A high-level command center that displays active event counts, uncollected client balances, outstanding vendor debt, and overdue task alerts. Four summary cards give you instant financial and operational health at a glance.

• Active Events Count — live tally of ongoing and upcoming events
• Uncollected Revenue — remaining client balances across all projects
• Vendor Debt — total accounts payable to service providers
• Urgent Tasks — count of past-due milestones requiring attention

A sortable table showing your five most recent events with status badges (Upcoming, Ongoing, Completed), budget figures, client names, and date ranges. Each row has a dropdown for quick actions like viewing details, editing, or deleting.

• Status badges with color-coded indicators (blue/amber/emerald)
• Inline currency formatting via formatUSD helper
• Quick-action dropdown (view, edit, delete) per event

Aggregated financial intelligence across all your events. The finance page computes total revenue, vendor liabilities, cash-on-hand, and estimated net profit with margin percentage.

• Total Revenue — sum of all event budgets
• Vendor Liabilities — total contracted vendor costs vs. paid out
• Cash on Hand — collected client payments minus vendor payouts
• Est. Net Profit — budget minus total liability with margin %

A polished form with real-time readiness progress bar. Fields include title, client name, contact email, venue location, budget estimate, start/end dates with time, and a vision description. Validates all inputs with shake animations on error.

• Readiness progress bar — tracks form completion percentage live
• Smart validation — required fields, date ordering, non-negative budget
• Shake animation on invalid fields with scroll-to-first-error
• Supports both create and edit modes from the same component

A comprehensive event detail page with real-time stats, financial breakdowns, active milestones, and a full audit trail. Displays event status with a live ping indicator and animated badges.

• Stat cards — timeline, location, milestone completion %, vendor count
• Overview cards — total budget, vendor liability, settled amount, reserves
• Capital management — budget utilization bar, over-budget warnings
• Active milestones — timeline of incomplete tasks with due dates
• Audit trail — chronological activity feed (task created/completed, vendor added/paid)

A live countdown component showing days, hours, minutes, and seconds remaining until the event starts. Includes client name, location display, and real-time countdown updates.

• Real-time countdown timer to event start
• Client and location info displayed prominently
• Animates on mount with a fade-in effect

A centralized database of all your service providers. Each vendor has a name, category, website, contact info, and active status. Supports full CRUD with inline search, filtering by category, and bulk archive operations.

• Create, update, and soft-delete (archive) vendors
• Bulk archive with confirmation dialog
• Search by name with real-time filtering
• Sort by name (asc/desc), category, or recently added
• Category tagging for organization (catering, venue, photography, etc.)

Assign global vendors to specific events with cost, deposit, and due date. Automatically creates an initial deposit payment when a deposit amount is set. Prevents duplicate vendor assignments per event.

• Link vendors to events with cost, deposit, and due date
• Auto-creates Vendor payment record for deposits
• Prevents duplicate vendor links per event
• Update linked vendor cost and due date
• Bulk unlink vendors from an event

Per-event vendor management page showing all linked vendors with their payment status (Paid, Pending, Overdue), costs, deposits, due dates, and progress bars toward full payment.

• Payment status badges with color coding
• Progress bars showing payment completion %
• Cost vs. deposit vs. paid amount breakdown
• Dropdown actions — edit link, view payments, unlink
• Quick-link button to add more vendors to the event

Record payments of two types — Client (inbound revenue) and Vendor (outbound expenses). Each payment tracks amount, due date, description, and optional vendor association. Supports full CRUD with optimistic updates.

• Client payments — track inbound revenue from event clients
• Vendor payments — track outbound payouts to service providers
• Associate payments with specific linked vendors
• Full CRUD with real-time UI updates via React Query
• Modal form with event and vendor selectors

Real-time budget utilization tracking with color-coded progress bars and warning states. Shows remaining budget, contracted amounts, paid amounts, and over-budget alerts with animated pulse effects.

• Budget utilization bar with emerald/amber/rose color states
• Over-budget detection with pulsing warning indicator
• Remaining budget calculation after vendor contracts
• Payment completion percentage per event

An aggregated finance page showing total revenue, vendor liabilities, cash on hand, and estimated net profit across all events. Includes a complete payment history table with status filters and export capabilities.

• Global finance stats across all events
• Payment history table with type, amount, status, and event
• Client/Vendor payment type filtering
• Event-specific financial breakdown pages

Create tasks tied to events with title, description, assigned team member, status (Pending, InProgress, Done), due date, and priority (Low, Medium, High, Urgent). Full CRUD with a Kanban-style table and inline status changes.

• Four priority levels — Urgent (rose), High (orange), Medium (amber), Low (blue)
• Three statuses — Pending, InProgress, Done
• Task completion auto-creates activity log entries
• Inline status change with optimistic UI updates
• Overdue detection for past-due incomplete tasks

Per-event task management page with summary cards showing total, pending, in-progress, done, urgent, and overdue task counts. Includes a searchable, filterable table with status badge colors.

• Summary stat cards — total, pending, in-progress, done, urgent, overdue
• Search tasks by title with real-time filtering
• Status and priority badge colors for visual scanning
• Task creation sheet with complete form
• Bulk operations for task management

Every significant action is logged as an activity entry — task created, task completed, vendor added, vendor updated, vendor paid. Each entry has a type-specific icon and color, displayed in a scrollable timeline.

• Five activity types with distinct colors and icons
• Chronological feed sorted by creation date
• Auto-logged on task/vendor/payment mutations
• Scrollable container for long activity histories

Powered by Clerk for authentication with a middleware proxy that protects all routes except public ones. A UserWatcher component auto-syncs Clerk user data to the backend database upon sign-in, creating or updating the user record.

• Clerk-powered authentication with modal sign-in/sign-up
• Middleware proxy protecting all routes except /features
• Auto-sync user profile to backend on sign-in
• Onboarding flow redirects to dashboard for existing users

The entire frontend uses TanStack React Query for server state management with automatic cache invalidation. Mutations optimistically update the UI, and queries refetch on window focus for always-fresh data.

• React Query for all API communication with caching
• Optimistic updates on mutations for instant UI feedback
• Automatic refetch on window focus and query invalidation
• Structured query options per entity (events, vendors, payments, tasks)

A dedicated stats service on the backend computes dashboard, event-specific, and financial statistics using parallelized Prisma queries within a single transaction for optimal performance.

• Dashboard stats — active events, vendor debt, uncollected, urgent tasks
• Event stats — budget utilization, task completion %, vendor payment status
• Finance stats — revenue, liabilities, cash on hand, profit margins
• All stats computed server-side via prisma $transaction for consistency

PostgreSQL database with Prisma ORM. Eight models: User, Event, GlobalVendor, EventVendor (junction), Payment, Task, Activity (audit log). All user data is isolated via userId, and cascading deletes ensure referential integrity.

• 8 database models with full relational integrity
• User-scoped data isolation on every query
• Cascade deletes — deleting an event removes all related tasks, vendors, payments
• Request context via AsyncLocalStorage for userId propagation
• Prisma adapter for PostgreSQL with connection pooling