{"id":48905349,"url":"https://github.com/arunava-12/zenspace","last_synced_at":"2026-04-16T19:59:45.031Z","repository":{"id":338682014,"uuid":"1155953878","full_name":"arunava-12/zenspace","owner":"arunava-12","description":"ZenSpace is a modern project management SaaS dashboard with AI-powered task assistance, real-time analytics, and a sleek glassmorphism UI for team collaboration.","archived":false,"fork":false,"pushed_at":"2026-04-16T10:51:30.000Z","size":607,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-16T19:59:43.217Z","etag":null,"topics":["prisma","production","project-management","react","render","saas","supabase","tailwindcss","task-manager","typescript","vercel"],"latest_commit_sha":null,"homepage":"https://zenspace-navy.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arunava-12.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-12T04:59:02.000Z","updated_at":"2026-04-16T10:51:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/arunava-12/zenspace","commit_stats":null,"previous_names":["arunava-12/zenspace"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/arunava-12/zenspace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arunava-12%2Fzenspace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arunava-12%2Fzenspace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arunava-12%2Fzenspace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arunava-12%2Fzenspace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arunava-12","download_url":"https://codeload.github.com/arunava-12/zenspace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arunava-12%2Fzenspace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31902123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["prisma","production","project-management","react","render","saas","supabase","tailwindcss","task-manager","typescript","vercel"],"created_at":"2026-04-16T19:59:43.418Z","updated_at":"2026-04-16T19:59:45.023Z","avatar_url":"https://github.com/arunava-12.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003ch1\u003e\n    \u003cimg src=\"./public/favicon.svg\" width=\"28\" style=\"vertical-align: middle;\" /\u003e\n    ZenSpace\n  \u003c/h1\u003e\n\n  \u003cp\u003e\u003cb\u003eA premium, full-stack project management SaaS platform designed for high-performance teams.\u003c/b\u003e\u003c/p\u003e\n  \u003cp\u003e\u003ci\u003eFind your flow in the chaos.\u003c/i\u003e\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"#-key-features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#%EF%B8%8F-technology-stack\"\u003eTech Stack\u003c/a\u003e •\n    \u003ca href=\"#-system-architecture\"\u003eArchitecture\u003c/a\u003e •\n    \u003ca href=\"#-getting-started\"\u003eInstallation\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cbr /\u003e\n\n  \u003c!-- Tech Icons --\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/React-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/TypeScript.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/NodeJS-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/PostgreSQL-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Prisma.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/ExpressJS-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/TailwindCSS-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Redux.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Vite-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Git.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Github-Dark.svg\" width=\"42\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/tandpfun/skill-icons/main/icons/Supabase-Dark.svg\" width=\"42\" /\u003e\n\n\u003c/div\u003e\n\n---\n\n## 🚀 Overview\n\nZenSpace combines a sleek, state-of-the-art **glassmorphic UI** with powerful **AI-assisted workflows**, **real-time collaboration**, and **robust data management**. Built to handle the demands of modern cross-functional teams, it enables you to manage your projects, tasks, and team interactions seamlessly.\n\n![React](https://img.shields.io/badge/React-19.0.0-61DAFB?style=for-the-badge\u0026logo=react\u0026logoColor=black)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.8.2-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n![Vite](https://img.shields.io/badge/Vite-6.2.0-646CFF?style=for-the-badge\u0026logo=vite\u0026logoColor=white)\n![PostgreSQL](https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)\n![Prisma](https://img.shields.io/badge/Prisma-6.17.0-2D3748?style=for-the-badge\u0026logo=prisma\u0026logoColor=white)\n![TailwindCSS](https://img.shields.io/badge/Tailwind_CSS-3.4-38B2AC?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white)\n![Groq](https://img.shields.io/badge/AI-Groq%20Llama%203.3-FF7B00?style=for-the-badge\u0026logo=groq\u0026logoColor=white)\n\n---\n\n## ✨ Key Features\n\n### 🏢 Workspace \u0026 Project Architecture\n* **Multi-Workspace Support**: Organize different business units or teams into isolated workspaces effortlessly.\n* **Granular Project Control**: Comprehensive project tracking with diverse lifecycle statuses (`Active`, `Planning`, `Completed`, `On Hold`, `Cancelled`).\n* **Visual Progress Tracking**: Real-time percentage-based progression and robust Priority Matrices (Low, Medium, High).\n\n### ✅ Advanced Task Management\n* **Kanban-Style Statuses**: Fluid workflows navigating through `To Do` → `In Progress` → `Done`.\n* **Categorized Task Types**: Effectively manage distinct task entities like `Tasks`, `Bugs`, `Features`, and `Improvements`.\n* **Smart Assignments**: Instantly assign tasks to specific team members, assign deadlines, and detail the scope.\n\n### 🤖 ZenAI Assistant\n* **AI Chatbot Context**: Context-aware assistant powered by **Groq** (using Llama 3.3).\n* **Intelligent Suggestions**: Ask the AI to brainstorm or even generate actionable JSON-mapped tasks dynamically based on project descriptions.\n\n### 👥 Collaboration \u0026 Security\n* **Role-Based Access Control (RBAC)**: Enforced internal security differentiating `Admin`, `Owner`, and `Member` privileges.\n* **Secure Invites**: Token-based architecture to seamlessly onboard new team members.\n* **Persistent Discussions**: Dynamic, threaded comments tied to projects and specific tasks ensuring deep collaboration.\n\n### 🎨 Premium Aesthetics (UX/UI)\n* **Glassmorphism**: High-end frosted glass elements with ultra-modern UI design languages.\n* **Complex UI Graphics**: GSAP and Framer Motion powered transitions across pages and interactions.\n* **Visual Calendar**: A beautiful integrated calendar system mapping out schedules interactively.\n\n---\n\n## 🛠️ Technology Stack\n\n| Domain | Technologies |\n| :--- | :--- |\n| **Frontend** | React 19, TypeScript, Vite, Tailwind CSS, Lucide React, GSAP, Framer Motion |\n| **Backend** | Node.js (Node 20+), Express.js |\n| **Database** | PostgreSQL, Prisma ORM |\n| **Authentication** | JWT (Cookie-based), bcryptjs |\n| **AI Integration** | Groq SDK (Llama 3.3-70b/8b) |\n\n---\n\n## 🧭 System Architecture\n\n```mermaid\ngraph TD\n    %% Frontend Node\n    Client[\"🖥️ React 19 SPA\u003cbr\u003e(Vite + Tailwind)\"]\n    \n    %% API Gateway Layer\n    Gateway[\"🌐 Express Server\u003cbr\u003e(REST API)\"]\n    \n    %% Backend Services\n    Auth[\"🛡️ Auth Service\u003cbr\u003e(JWT + bcrypt)\"]\n    Projects[\"📁 Project \u0026 Task\u003cbr\u003eManagement\"]\n    AI_Agent[\"🤖 ZenAI Agent\"]\n    \n    %% Database Connection Layer\n    ORM[\"🔷 Prisma ORM\"]\n    \n    %% Data Stores\n    DB[(\"🐘 PostgreSQL\u003cbr\u003eDatabase\")]\n    LLM[\"🧠 Groq API\u003cbr\u003e(Llama 3.3)\"]\n    \n    %% Relationships\n    Client \u003c--\u003e|Axios / JSON| Gateway\n    Gateway --\u003e Auth\n    Gateway --\u003e Projects\n    Gateway --\u003e AI_Agent\n    \n    Auth --\u003e ORM\n    Projects --\u003e ORM\n    \n    ORM \u003c--\u003e DB\n    AI_Agent \u003c--\u003e|Prompts / Streaming| LLM\n```\n\n### 🗄️ Database Entity-Relationship Diagram\n\n```mermaid\nerDiagram\n    USER ||--o{ WORKSPACE : \"creates \u0026 owns\"\n    USER ||--o{ PROJECT : \"leads\"\n    USER ||--o{ TASK : \"is assigned\"\n    USER ||--o{ COMMENT : \"authors\"\n    \n    WORKSPACE ||--o{ PROJECT : \"contains\"\n    \n    PROJECT ||--o{ TASK : \"houses\"\n    PROJECT ||--o{ PROJECT_INVITE : \"issues\"\n    PROJECT ||--o{ FILE_ASSET : \"attaches\"\n    \n    TASK ||--o{ COMMENT : \"contains\"\n    PROJECT ||--o{ COMMENT : \"contains\"\n```\n\n---\n\n## 🚀 Getting Started\n\n### Prerequisites\n* **Node.js 20+**\n* **PostgreSQL** Database \n* **Groq API Key** (or use Google Gemini fallback if configured)\n\n### Installation\n\n1. **Clone \u0026 Install**\n   ```bash\n   git clone https://github.com/your-username/zenspace.git\n   cd zenspace\n   \n   # Install Frontend Dependencies\n   npm install\n   \n   # Install Backend Dependencies\n   cd server\n   npm install\n   cd ..\n   ```\n\n2. **Environment Setup**\n   Ensure `.env` files are correctly set up in the root and `/server` directory.\n\n   **Root `.env` (Frontend):**\n   ```env\n   VITE_API_URL=http://localhost:4000\n   ```\n\n   **Server `.env` (`/server/.env`):**\n   ```env\n   DATABASE_URL=\"postgresql://user:password@localhost:5432/zenspace\"\n   DIRECT_URL=\"postgresql://user:password@localhost:5432/zenspace\"\n   JWT_SECRET=\"your_very_secure_secret\"\n   GROQ_API_KEY=\"your_groq_api_key_here\"\n   PORT=4000\n   ```\n\n3. **Database Initialization**\n   ```bash\n   cd server\n   \n   # Apply Prisma migrations\n   npx prisma migrate dev --name init\n   \n   # Optional: Seed the database with sample data\n   npm run db:seed \n   cd ..\n   ```\n\n4. **Run Development Servers**\n   To experience the full capability, run both client and server instances concurrently.\n   \n   ```bash\n   # Terminal 1: Frontend Server\n   npm run dev\n\n   # Terminal 2: Backend API\n   cd server\n   npm run dev\n   ```\n\n---\n\n## 📁 Project Structure\n\n```text\nzenspace/\n├── components/          # Reusable UI (BlobCursor, VisualCalendar, ZenAIChat)\n├── pages/               # Main Views (Dashboard, ProjectDetails, Tasks, etc.)\n├── store/               # Frontend State Management hook architectures\n├── public/              # Static Frontend Assets\n├── server/              # Express Backend Ecosystem\n│   ├── prisma/          # Prisma schema \u0026 seeding strategy\n│   ├── routes/          # Isolated API endpoint configurations\n│   ├── utils/           # Shared utility classes \u0026 helpers\n│   └── index.ts         # High-level server bootstrap\n├── types.ts             # Shared global TS interfaces\n└── tailwind.config.cjs  # Custom theme \u0026 animation constants\n```\n\n---\n\n## 📈 Roadmap\n\n- [x] Initial React 19 Migration \u0026 UI Rewrite.\n- [x] AI agent integration via Groq for generative tasks.\n- [x] Full DB relations with Tasks, Comments \u0026 Projects.\n- [ ] Real-time WebSockets setup for live collaboration UI updates.\n- [ ] Drag-and-drop Kanban interface components.\n- [ ] Comprehensive File/Asset cloud storage (AWS S3) configuration.\n- [ ] Cross-platform React Native companion app.\n\n---\n\n## 🤝 Contributing\n\nWe welcome community contributions to ZenSpace! \n\n1. **Fork the Project**\n2. **Create your Feature Branch** (`git checkout -b feature/AmazingFeature`)\n3. **Commit your Changes** (`git commit -m 'Add some AmazingFeature'`)\n4. **Push to the Branch** (`git push origin feature/AmazingFeature`)\n5. **Open a Pull Request**\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cb\u003eBuilt with pride for the modern workforce.\u003c/b\u003e\n  \u003cbr\u003e\n  \u003ci\u003eCopyright © 2026 ZenSpace Ecosystem\u003c/i\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farunava-12%2Fzenspace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farunava-12%2Fzenspace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farunava-12%2Fzenspace/lists"}