# Project export: PM.ai This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: Cal Hacks 12.0 - Tagline: AI tool that reads project briefs, auto-creates tasks, assigns roles, and syncs updates—turning scattered project chaos into clear, organized teamwork powered by Claude, Supabase, & Chroma. - Devpost: https://devpost.com/software/pm-ai - GitHub: https://github.com/KairiNavratil/ProjectManagerAI/ - Video: https://www.youtube.com/embed/-scuCTsPy0I?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: 3 GitHub contributor(s) — Ricardo Escalante (12 commits), Khas-Erdene221 (2 commits), Kairi Navratil (1 commits) ## Devpost submission (written by the team) ### Inspiration As engineers, we’ve all experienced the chaos of collaborating on complex projects—messages scattered across Discord, Slack, and Notion; roles unclear; and deadlines slipping through the cracks. During the hackathon, our team realized that what slows teams down isn’t just lack of talent—it’s lack of clarity. We wanted to build an AI-powered orchestrator that could read a project brief, understand what needs to be done, and automatically divide it into actionable tasks and clear roles — giving every team member instant alignment. ### What it does PM.ai is an intelligent project management assistant that: Reads your project or assignment brief (PDF/text) Automatically identifies roles (like Backend Developer, PM, UI/UX Designer) Breaks down large goals into actionable tasks and subtasks Assigns responsibilities based on role specialization Stores everything in a collaborative Supabase dashboard so teams can interact, claim tasks, and stay updated It acts like your AI project manager — one that never forgets, never misses a deadline, and keeps everyone on the same page. ### How we built it Our stack was designed around reliability, reasoning, and speed: Claude 4.5 (Anthropic) for advanced reasoning, structured JSON task generation, and long-context understanding of project briefs LangChain for chaining AI prompts and embedding logic Chroma for vector-based “memory” retrieval of project content Supabase for relational storage of roles, tasks, and subtasks (pgvector used for memory embeddings) FastAPI as the backend for uploading files, calling agents, and connecting to Supabase Supabase Edge Functions to bulk-insert and manage data asynchronously The workflow: User uploads a project brief → extracted with pdf-parse Text is chunked, embedded, and stored in Chroma Claude’s PM Agent generates high-level tasks and roles Claude’s Specialist Agents expand each task into technical subtasks 5.All data syncs into Supabase and is displayed in the interactive dashboard ### Challenges we ran into Model formatting: Early versions of Claude’s JSON responses were inconsistent. We had to sanitize and validate outputs before inserting them into Supabase. Supabase schema setup: Managing relationships between projects, tasks, and subtasks without breaking function permissions required careful design. ### Accomplishments we're proud of Built a fully functional multi-agent orchestration system that dynamically parses, structures, and assigns project tasks. Integrated Claude 4.5, Supabase, and Chroma successfully — all talking to each other through FastAPI. Achieved structured, reusable JSON pipelines for consistent AI task generation. Created a system that we actually used to manage our own hackathon workflow — proving its effectiveness. Built a team that combined AI, backend, and UX thinking seamlessly. ### What we learned The power of AI orchestration — how chaining reasoning agents can create structured workflows from unstructured input. How to design robust API systems that handle dynamic AI responses (even malformed JSON). The value of clear schema design in Supabase for linking project hierarchies (projects → tasks → subtasks). That collaboration and communication—ironically, the problem we were solving—are what make hackathon success possible. ### What's next Autonomous Planning: Let PM.ai dynamically replan deadlines or reassign roles when someone misses a milestone. SaaS Launch: Turn this into a lightweight productivity platform for startups, research labs, and university teams. ## README (from the GitHub repository) No README available. ## Detected evidence (automated analysis) Indexed codebase: 82 recognized source files, 232 KB. - CSS (language) — detected in the code - HTML (language) — detected in the code - JavaScript (language) — detected in the code - React (technology) — detected in the code - Supabase (technology) — detected in the code - Tailwind CSS (technology) — detected in the code - TypeScript (language) — detected in the code - FastAPI (technology) — claimed on Devpost, not found in the code - LangChain (technology) — claimed on Devpost, not found in the code ## Codebase structure (from repository index) ### Files (91 of 91) ``` frontend/.gitignore frontend/bun.lockb frontend/components.json frontend/eslint.config.js frontend/index.html frontend/package.json frontend/postcss.config.js frontend/public/robots.txt frontend/README.md frontend/src/App.css frontend/src/App.tsx frontend/src/components/AIAssistant.tsx frontend/src/components/CreateProjectDialog.tsx frontend/src/components/FileUpload.tsx frontend/src/components/InviteMemberDialog.tsx frontend/src/components/KanbanBoard.tsx frontend/src/components/Navbar.tsx frontend/src/components/ProjectCard.tsx frontend/src/components/ReportDetailDialog.tsx frontend/src/components/RoadmapView.tsx frontend/src/components/TeamMemberTasksDialog.tsx frontend/src/components/TeamPanel.tsx frontend/src/components/ui/accordion.tsx frontend/src/components/ui/alert-dialog.tsx frontend/src/components/ui/alert.tsx frontend/src/components/ui/aspect-ratio.tsx frontend/src/components/ui/avatar.tsx frontend/src/components/ui/badge.tsx frontend/src/components/ui/breadcrumb.tsx frontend/src/components/ui/button.tsx frontend/src/components/ui/calendar.tsx frontend/src/components/ui/card.tsx frontend/src/components/ui/carousel.tsx frontend/src/components/ui/chart.tsx frontend/src/components/ui/checkbox.tsx frontend/src/components/ui/collapsible.tsx frontend/src/components/ui/command.tsx frontend/src/components/ui/context-menu.tsx frontend/src/components/ui/dialog.tsx frontend/src/components/ui/drawer.tsx frontend/src/components/ui/dropdown-menu.tsx frontend/src/components/ui/form.tsx frontend/src/components/ui/hover-card.tsx frontend/src/components/ui/input-otp.tsx frontend/src/components/ui/input.tsx frontend/src/components/ui/label.tsx frontend/src/components/ui/menubar.tsx frontend/src/components/ui/navigation-menu.tsx frontend/src/components/ui/pagination.tsx frontend/src/components/ui/popover.tsx frontend/src/components/ui/progress.tsx frontend/src/components/ui/radio-group.tsx frontend/src/components/ui/resizable.tsx frontend/src/components/ui/scroll-area.tsx frontend/src/components/ui/select.tsx frontend/src/components/ui/separator.tsx frontend/src/components/ui/sheet.tsx frontend/src/components/ui/sidebar.tsx frontend/src/components/ui/skeleton.tsx frontend/src/components/ui/slider.tsx frontend/src/components/ui/sonner.tsx frontend/src/components/ui/switch.tsx frontend/src/components/ui/table.tsx frontend/src/components/ui/tabs.tsx frontend/src/components/ui/textarea.tsx frontend/src/components/ui/toast.tsx frontend/src/components/ui/toaster.tsx frontend/src/components/ui/toggle-group.tsx frontend/src/components/ui/toggle.tsx frontend/src/components/ui/tooltip.tsx frontend/src/components/ui/use-toast.ts frontend/src/hooks/use-mobile.tsx frontend/src/hooks/use-toast.ts frontend/src/index.css frontend/src/lib/utils.ts frontend/src/main.tsx frontend/src/pages/Dashboard.tsx frontend/src/pages/Index.tsx frontend/src/pages/NotFound.tsx frontend/src/pages/ProjectDetail.tsx frontend/src/pages/Reports.tsx frontend/src/pages/Settings.tsx frontend/src/pages/Team.tsx frontend/src/utils/supabase.ts frontend/src/vite-env.d.ts frontend/tailwind.config.ts frontend/tsconfig.app.json frontend/tsconfig.json frontend/tsconfig.node.json frontend/vite.config.ts LICENSE ``` ### Dependencies - frontend/package.json: @eslint/js@^9.32.0, @hookform/resolvers@^3.10.0, @radix-ui/react-accordion@^1.2.11, @radix-ui/react-alert-dialog@^1.1.14, @radix-ui/react-aspect-ratio@^1.1.7, @radix-ui/react-avatar@^1.1.10, @radix-ui/react-checkbox@^1.3.2, @radix-ui/react-collapsible@^1.1.11, @radix-ui/react-context-menu@^2.2.15, @radix-ui/react-dialog@^1.1.14, @radix-ui/react-dropdown-menu@^2.1.15, @radix-ui/react-hover-card@^1.1.14, @radix-ui/react-label@^2.1.7, @radix-ui/react-menubar@^1.1.15, @radix-ui/react-navigation-menu@^1.2.13, @radix-ui/react-popover@^1.1.14, @radix-ui/react-progress@^1.1.7, @radix-ui/react-radio-group@^1.3.7, @radix-ui/react-scroll-area@^1.2.9, @radix-ui/react-select@^2.2.5, @radix-ui/react-separator@^1.1.7, @radix-ui/react-slider@^1.3.5, @radix-ui/react-slot@^1.2.3, @radix-ui/react-switch@^1.2.5, @radix-ui/react-tabs@^1.1.12, @radix-ui/react-toast@^1.2.14, @radix-ui/react-toggle@^1.1.9, @radix-ui/react-toggle-group@^1.1.10, @radix-ui/react-tooltip@^1.2.7, @supabase/supabase-js@^2.76.1, @tailwindcss/typography@^0.5.16, @tanstack/react-query@^5.83.0, @types/node@^22.16.5, @types/react@^18.3.23, @types/react-dom@^18.3.7, @vitejs/plugin-react-swc@^3.11.0, autoprefixer@^10.4.21, class-variance-authority@^0.7.1, clsx@^2.1.1, cmdk@^1.1.1, date-fns@^3.6.0, embla-carousel-react@^8.6.0, eslint@^9.32.0, eslint-plugin-react-hooks@^5.2.0, eslint-plugin-react-refresh@^0.4.20, globals@^15.15.0, input-otp@^1.4.2, lovable-tagger@^1.1.11, lucide-react@^0.462.0, next-themes@^0.3.0, postcss@^8.5.6, react@^18.3.1, react-day-picker@^8.10.1, react-dom@^18.3.1, react-hook-form@^7.61.1, react-resizable-panels@^2.1.9, react-router-dom@^6.30.1, recharts@^2.15.4, sonner@^1.7.4, tailwind-merge@^2.6.0, tailwindcss@^3.4.17, tailwindcss-animate@^1.0.7, typescript@^5.8.3, typescript-eslint@^8.38.0, vaul@^0.9.9, vite@^5.4.19, zod@^3.25.76 ### Recent commits (newest first) - delete task working - added workign task adding button - Merge pull request #1 from KairiNavratil/dev/ricardo/addProject - create project semi working - fixed uplaodUrl - test - changed basic favicon and html - Create package-lock.json - test - workign on fild upload - adding an update projects function to update task completion - individual project todo lists synced up - project realtime is working - integrated supabase function to get projects from database - Merge commit 'd331b52059a6849a9057a99a03ba6abe390b6826' as 'frontend' - Squashed 'frontend/' content from commit 746f117 - Initial commit ## Key source files (fetched from GitHub, selected and truncated for size) ### frontend/package.json ``` { "name": "vite_react_shadcn_ts", "private": true, "version": "0.0.0", "type": "module", "scripts": { "dev": "vite", "build": "vite build", "build:dev": "vite build --mode development", "lint": "eslint .", "preview": "vite preview" }, "dependencies": { "@hookform/resolvers": "^3.10.0", "@radix-ui/react-accordion": "^1.2.11", "@radix-ui/react-alert-dialog": "^1.1.14", "@radix-ui/react-aspect-ratio": "^1.1.7", "@radix-ui/react-avatar": "^1.1.10", "@radix-ui/react-checkbox": "^1.3.2", "@radix-ui/react-collapsible": "^1.1.11", "@radix-ui/react-context-menu": "^2.2.15", "@radix-ui/react-dialog": "^1.1.14", "@radix-ui/react-dropdown-menu": "^2.1.15", "@radix-ui/react-hover-card": "^1.1.14", "@radix-ui/react-label": "^2.1.7", "@radix-ui/react-menubar": "^1.1.15", "@radix-ui/react-navigation-menu": "^1.2.13", "@radix-ui/react-popover": "^1.1.14", "@radix-ui/react-progress": "^1.1.7", "@radix-ui/react-radio-group": "^1.3.7", "@radix-ui/react-scroll-area": "^1.2.9", "@radix-ui/react-select": "^2.2.5", "@radix-ui/react-separator": "^1.1.7", "@radix-ui/react-slider": "^1.3.5", "@radix-ui/react-slot": "^1.2.3", "@radix-ui/react-switch": "^1.2.5", "@radix-ui/react-tabs": "^1.1.12", "@radix-ui/react-toast": "^1.2.14", "@radix-ui/react-toggle": "^1.1.9", "@radix-ui/react-toggle-group": "^1.1.10", "@radix-ui/react-tooltip": "^1.2.7", "@supabase/supabase-js": "^2.76.1", "@tanstack/react-query": "^5.83.0", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", "cmdk": "^1.1.1", "date-fns": "^3.6.0", "embla-carousel-react": "^8.6.0", "input-otp": "^1.4.2", "lucide-react": "^0.462.0", "next-themes": "^0.3.0", "react": "^18.3.1", "react-day-picker": "^8.10.1", "react-dom": "^18.3.1", "react-hook-form": "^7.61.1", "react-resizable-panels": "^2.1.9", "react-router-dom": "^6.30.1", "recharts": "^2.15.4", "sonner": "^1.7.4", "tailwind-merge": "^2.6.0", "tailwindcss-animate": "^1.0.7", "vaul": "^0.9.9", "zod": "^3.25.76" }, "devDependencies": { "@eslint/js": "^9.32.0", "@tailwindcss/typography": "^0.5.16", "@types/node": "^22.16.5", "@types/react": "^18.3.23", "@types/react-dom": "^18.3.7", "@vitejs/plugin-react-swc": "^3.11.0", "autoprefixer": "^10.4.21", "eslint": "^9.32.0", "eslint-plugin-react-hooks": "^5.2.0", "eslint-plugin-react-refresh": "^0.4.20", "globals": "^15.15.0", "lovable-tagger": "^1.1.11", "postcss": "^8.5.6", "tailwindcss": "^3.4.17", "typescript": "^5.8.3", "typescript-eslint": "^8.38.0", "vite": "^5.4.19" } } ``` ### frontend/src/main.tsx ```typescript import { createRoot } from "react-dom/client"; import App from "./App.tsx"; import "./index.css"; createRoot(document.getElementById("root")!).render(); ``` ### frontend/src/App.tsx ```typescript import { Toaster } from "@/components/ui/toaster"; import { Toaster as Sonner } from "@/components/ui/sonner"; import { TooltipProvider } from "@/components/ui/tooltip"; import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; import { BrowserRouter, Routes, Route, Navigate } from "react-router-dom"; import Dashboard from "./pages/Dashboard"; import ProjectDetail from "./pages/ProjectDetail"; import Team from "./pages/Team"; import Reports from "./pages/Reports"; import Settings from "./pages/Settings"; import NotFound from "./pages/NotFound"; const queryClient = new QueryClient(); const App = () => ( } /> } /> } /> } /> } /> } /> } /> ); export default App; ``` ### frontend/src/pages/Index.tsx ```typescript // Update this page (the content is just a fallback if you fail to update the page) const Index = () => { return (

Welcome to Your Blank App

Start building your amazing project here!

); }; export default Index; ``` ### frontend/postcss.config.js ```javascript export default { plugins: { tailwindcss: {}, autoprefixer: {}, }, }; ``` ### frontend/vite.config.ts ```typescript import { defineConfig } from "vite"; import react from "@vitejs/plugin-react-swc"; import path from "path"; import { componentTagger } from "lovable-tagger"; // https://vitejs.dev/config/ export default defineConfig(({ mode }) => ({ server: { host: "::", port: 8080, }, plugins: [react(), mode === "development" && componentTagger()].filter(Boolean), resolve: { alias: { "@": path.resolve(__dirname, "./src"), }, }, })); ``` ### frontend/eslint.config.js ```javascript import js from "@eslint/js"; import globals from "globals"; import reactHooks from "eslint-plugin-react-hooks"; import reactRefresh from "eslint-plugin-react-refresh"; import tseslint from "typescript-eslint"; export default tseslint.config( { ignores: ["dist"] }, { extends: [js.configs.recommended, ...tseslint.configs.recommended], files: ["**/*.{ts,tsx}"], languageOptions: { ecmaVersion: 2020, globals: globals.browser, }, plugins: { "react-hooks": reactHooks, "react-refresh": reactRefresh, }, rules: { ...reactHooks.configs.recommended.rules, "react-refresh/only-export-components": ["warn", { allowConstantExport: true }], "@typescript-eslint/no-unused-vars": "off", }, }, ); ``` ### frontend/index.html ```html PM.ai - AI-Powered Team Project Manager
``` ### frontend/tailwind.config.ts ```typescript import type { Config } from "tailwindcss"; export default { darkMode: ["class"], content: ["./pages/**/*.{ts,tsx}", "./components/**/*.{ts,tsx}", "./app/**/*.{ts,tsx}", "./src/**/*.{ts,tsx}"], prefix: "", theme: { container: { center: true, padding: "2rem", screens: { "2xl": "1400px", }, }, extend: { colors: { border: "hsl(var(--border))", input: "hsl(var(--input))", ring: "hsl(var(--ring))", background: "hsl(var(--background))", foreground: "hsl(var(--foreground))", primary: { DEFAULT: "hsl(var(--primary))", foreground: "hsl(var(--primary-foreground))", }, secondary: { DEFAULT: "hsl(var(--secondary))", foreground: "hsl(var(--secondary-foreground))", }, destructive: { DEFAULT: "hsl(var(--destructive))", foreground: "hsl(var(--destructive-foreground))", }, muted: { DEFAULT: "hsl(var(--muted))", foreground: "hsl(var(--muted-foreground))", }, accent: { DEFAULT: "hsl(var(--accent))", foreground: "hsl(var(--accent-foreground))", }, popover: { DEFAULT: "hsl(var(--popover))", foreground: "hsl(var(--popover-foreground))", }, card: { DEFAULT: "hsl(var(--card))", foreground: "hsl(var(--card-foreground))", }, sidebar: { DEFAULT: "hsl(var(--sidebar-background))", foreground: "hsl(var(--sidebar-foreground))", primary: "hsl(var(--sidebar-primary))", "primary-foreground": "hsl(var(--sidebar-primary-foreground))", accent: "hsl(var(--sidebar-accent))", "accent-foreground": "hsl(var(--sidebar-accent-foreground))", border: "hsl(var(--sidebar-border))", ring: "hsl(var(--sidebar-ring))", }, }, borderRadius: { lg: "var(--radius)", md: "calc(var(--radius) - 2px)", sm: "calc(var(--radius) - 4px)", }, keyframes: { "accordion-down": { from: { height: "0", }, to: { height: "var(--radix-accordion-content-height)", }, }, "accordion-up": { from: { height: "var(--radix-accordion-content-height)", }, to: { height: "0", }, }, "fade-in": { from: { opacity: "0", transform: "translateY(10px)", }, to: { opacity: "1", transform: "translateY(0)", }, }, "slide-in": { from: { transform: "translateX(-10px)", opacity: "0", }, to: { transform: "translateX(0)", opacity: "1", }, }, }, animation: { "accordion-down": "accordion-down 0.2s ease-out", "accordion-up": "accordion-up 0.2s ease-out", "fade-in": "fade-in 0.5s ease-out", "slide-in": "slide-in 0.3s ease-out", }, boxShadow: { 'glow': 'var(--shadow-glow)', }, backgroundImage: { 'gradient-primary': 'var(--gradient-primary)', 'gradient-accent': 'var(--gradient-accent)', }, }, }, plugins: [require("tailwindcss-animate")], } satisfies Config; ``` ### frontend/src/vite-env.d.ts ```typescript /// ``` [72 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]