{"id":51296734,"url":"https://github.com/itssanthoshhere/ghost-arc","last_synced_at":"2026-06-30T15:02:52.886Z","repository":{"id":356996262,"uuid":"1234898394","full_name":"Itssanthoshhere/Ghost-Arc","owner":"Itssanthoshhere","description":"👻 AI-powered collaborative architecture design platform with real-time multiplayer canvas, Gemini AI agents, Liveblocks sync, and automated technical spec generation.","archived":false,"fork":false,"pushed_at":"2026-05-13T16:42:42.000Z","size":1684,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-30T19:21:46.962Z","etag":null,"topics":["architecture-diagram","collaborative-editor","fullstack","liveblocks","postgresql","prisma","realtime-collaboration","system-design","triggerdev"],"latest_commit_sha":null,"homepage":"https://ghost-ai-zeta-seven.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/Itssanthoshhere.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-10T19:32:11.000Z","updated_at":"2026-05-13T16:43:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Itssanthoshhere/Ghost-Arc","commit_stats":null,"previous_names":["itssanthoshhere/ghost-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Itssanthoshhere/Ghost-Arc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Itssanthoshhere%2FGhost-Arc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Itssanthoshhere%2FGhost-Arc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Itssanthoshhere%2FGhost-Arc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Itssanthoshhere%2FGhost-Arc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Itssanthoshhere","download_url":"https://codeload.github.com/Itssanthoshhere/Ghost-Arc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Itssanthoshhere%2FGhost-Arc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34971635,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["architecture-diagram","collaborative-editor","fullstack","liveblocks","postgresql","prisma","realtime-collaboration","system-design","triggerdev"],"created_at":"2026-06-30T15:02:44.195Z","updated_at":"2026-06-30T15:02:52.873Z","avatar_url":"https://github.com/Itssanthoshhere.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003cimg src=\"public/readme/readme-hero.webp\" alt=\"Ghost Arc Banner\" /\u003e\n\n# 👻 Ghost Arc\n\n### AI-Powered Collaborative System Architecture Platform\n\n\u003e Design scalable software systems with AI, collaborate in real-time, and generate production-ready technical specifications instantly.\n\n\u003cimg src=\"https://img.shields.io/badge/Next.js-16-black?style=for-the-badge\u0026logo=nextdotjs\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/React-19-61DAFB?style=for-the-badge\u0026logo=react\u0026logoColor=black\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/TailwindCSS-v4-06B6D4?style=for-the-badge\u0026logo=tailwindcss\u0026logoColor=white\" /\u003e\n\u003cbr /\u003e\n\n\u003cimg src=\"https://img.shields.io/badge/Prisma-2D3748?style=for-the-badge\u0026logo=prisma\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/PostgreSQL-336791?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Liveblocks-000000?style=for-the-badge\u0026logo=liveblocks\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Trigger.dev-22C55E?style=for-the-badge\u0026logo=triggerdotdev\u0026logoColor=white\" /\u003e\n\u003cbr /\u003e\n\n\u003cimg src=\"https://img.shields.io/badge/Clerk-6C47FF?style=for-the-badge\u0026logo=clerk\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Gemini_AI-4285F4?style=for-the-badge\u0026logo=google\u0026logoColor=white\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/React_Flow-FF0072?style=for-the-badge\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Vercel-000000?style=for-the-badge\u0026logo=vercel\u0026logoColor=white\" /\u003e\n\n\u003cbr /\u003e\n\n\u003ca href=\"https://ghost-ai-zeta-seven.vercel.app/\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/🚀%20Live%20Demo-black?style=for-the-badge\u0026logo=vercel\u0026logoColor=white\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/Itssanthoshhere/Ghost-Arc\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/GitHub-181717?style=for-the-badge\u0026logo=github\u0026logoColor=white\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://santhosh-vs-portfolio.vercel.app\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/🌐%20Portfolio-000000?style=for-the-badge\u0026logo=vercel\u0026logoColor=white\" /\u003e\n\u003c/a\u003e\n\n\u003c/div\u003e\n\n---\n\n# 📋 Table of Contents\n\n- [📖 About The Project](#-about-the-project)\n- [✨ Features](#-features)\n- [🧠 How It Works](#-how-it-works)\n- [🏗️ Architecture](#️-architecture)\n- [⚙️ Tech Stack](#️-tech-stack)\n- [📂 Project Structure](#-project-structure)\n- [🚀 Getting Started](#-getting-started)\n- [🔐 Environment Variables](#-environment-variables)\n- [🎯 Core AI Workflow](#-core-ai-workflow)\n- [⚡ Performance Optimizations](#-performance-optimizations)\n- [🧪 Future Improvements](#-future-improvements)\n- [🤝 Contributing](#-contributing)\n- [👨‍💻 Author](#-author)\n\n---\n\n# 📖 About The Project\n\n**Ghost Arc** is an AI-powered collaborative architecture design platform that helps developers and software teams generate scalable system designs using natural language.\n\nInstead of manually drawing architecture diagrams and writing lengthy technical documentation, users can simply describe a system like:\n\nDesign a scalable e-commerce backend with authentication,\npayment gateway, Redis caching, and microservices\n\nGhost Arc uses **Google Gemini AI** to autonomously generate architecture nodes and connections on a collaborative React Flow canvas in real time.\n\nMultiple users can join the same workspace, edit diagrams together, and generate production-ready technical specifications instantly.\n\n---\n\n## 🎯 Problem It Solves\n\nModern software teams often struggle with:\n\n- Manual architecture diagram creation\n- Outdated technical documentation\n- Slow collaboration workflows\n- Repetitive system design discussions\n- Poor visibility into architectural decisions\n\nGhost Arc solves this by combining:\n\n- 🤖 AI-generated architecture planning\n- ⚡ Real-time multiplayer collaboration\n- 🧠 AI-generated technical documentation\n- 📦 Persistent project management\n- 🔄 Live synchronization across users\n\n---\n\n# ✨ Features\n\n## 🤖 AI Architecture Agent\n\nDescribe your system in plain English and let Gemini AI generate architecture diagrams automatically.\n\n---\n\n## 👥 Multiplayer Collaboration\n\nReal-time shared canvas powered by Liveblocks:\n\n- Live cursors\n- Presence indicators\n- Shared canvas state\n- Synchronized editing\n\n---\n\n## 🧠 AI Technical Specification Generator\n\nGenerate multi-page Markdown technical specifications directly from the architecture graph.\n\nIncludes:\n\n- System overview\n- Database design\n- API architecture\n- Deployment recommendations\n- Scalability notes\n\n---\n\n## 🎨 Interactive React Flow Canvas\n\nSupports:\n\n- Drag \u0026 drop nodes\n- Resizable components\n- Custom node styling\n- Dynamic edges\n- Inline editing\n- Color customization\n\n---\n\n## 💾 Persistent Project Storage\n\nProjects are stored using:\n\n- PostgreSQL (metadata)\n- Blob storage (spec files)\n- JSON canvas persistence\n\n---\n\n## 🔐 Authentication \u0026 Access Control\n\nSecure authentication powered by Clerk:\n\n- Sign in / Sign up\n- Protected routes\n- Session handling\n- User-based project access\n\n---\n\n## ⚡ Background AI Workflows\n\nLong-running AI tasks handled by Trigger.dev:\n\n- AI architecture generation\n- Spec generation\n- Retry handling\n- Workflow orchestration\n\n---\n\n# 🧠 How It Works\n\n## AI Architecture Generation Flow\n\n```text\nUser Prompt\n   ↓\nTrigger.dev Background Task\n   ↓\nGemini AI Tool Calling\n   ↓\nStructured Architecture Actions\n   ↓\nLiveblocks Storage Mutation\n   ↓\nRealtime Canvas Update\n```\n\n---\n\n## Technical Specification Flow\n\n```text\nCanvas Graph\n   ↓\nContext Builder\n   ↓\nGemini AI\n   ↓\nMarkdown Generation\n   ↓\nBlob Storage Upload\n   ↓\nDownloadable Technical Spec\n```\n\n---\n\n# 🏗️ Architecture\n\n```text\n┌──────────────────────────────────────────────┐\n│                 Frontend                     │\n│      Next.js + React + React Flow           │\n└──────────────────────────────────────────────┘\n                     ↓\n┌──────────────────────────────────────────────┐\n│                 API Layer                    │\n│         Next.js Route Handlers               │\n└──────────────────────────────────────────────┘\n                     ↓\n┌──────────────────────────────────────────────┐\n│            Background Workflows              │\n│                Trigger.dev                   │\n└──────────────────────────────────────────────┘\n                     ↓\n┌──────────────────────────────────────────────┐\n│               AI Processing                  │\n│            Google Gemini Models              │\n└──────────────────────────────────────────────┘\n                     ↓\n┌──────────────────────────────────────────────┐\n│            Realtime Collaboration            │\n│                Liveblocks                    │\n└──────────────────────────────────────────────┘\n                     ↓\n┌──────────────────────────────────────────────┐\n│                 Persistence                  │\n│     PostgreSQL + Prisma + Blob Storage       │\n└──────────────────────────────────────────────┘\n```\n\n---\n\n# ⚙️ Tech Stack\n\n| Category        | Technology     | Purpose                         |\n| --------------- | -------------- | ------------------------------- |\n| Frontend        | Next.js 16     | Full-stack React framework      |\n| UI              | React 19       | Component-based architecture    |\n| Language        | TypeScript     | Type safety                     |\n| Styling         | TailwindCSS v4 | Utility-first styling           |\n| Realtime        | Liveblocks     | Multiplayer collaboration       |\n| Authentication  | Clerk          | Auth \u0026 user management          |\n| Database        | PostgreSQL     | Persistent storage              |\n| ORM             | Prisma         | Database modeling               |\n| AI              | Google Gemini  | AI architecture generation      |\n| Background Jobs | Trigger.dev    | Async AI workflows              |\n| Flow Editor     | React Flow     | Interactive architecture canvas |\n| Deployment      | Vercel         | Hosting platform                |\n\n---\n\n# 📂 Project Structure\n\n```bash\nGhost-Arc/\n│\n├── app/\n│   ├── api/                  # API route handlers\n│   ├── editor/               # Collaborative editor pages\n│   ├── sign-in/              # Clerk auth pages\n│   └── sign-up/\n│\n├── components/\n│   ├── editor/               # Canvas/editor components\n│   └── ui/                   # Reusable UI primitives\n│\n├── hooks/                    # Custom React hooks\n│\n├── lib/\n│   ├── ai/                   # Gemini AI logic\n│   ├── liveblocks/           # Liveblocks config\n│   ├── prisma/               # Prisma client\n│   └── utils/\n│\n├── prisma/\n│   ├── schema.prisma\n│   └── migrations/\n│\n├── trigger/\n│   ├── design-agent.ts       # AI architecture generation\n│   └── generate-spec.ts      # AI spec generation\n│\n├── data/\n│   ├── canvas/\n│   └── specs/\n│\n└── types/\n```\n\n---\n\n# 🚀 Getting Started\n\n## Prerequisites\n\nMake sure you have installed:\n\n- Node.js \u003e= 18\n- npm\n- PostgreSQL\n- Git\n\n---\n\n## 1. Clone Repository\n\n```bash\ngit clone https://github.com/Itssanthoshhere/Ghost-Arc.git\n\ncd Ghost-Arc\n```\n\n---\n\n## 2. Install Dependencies\n\n```bash\nnpm install\n```\n\n---\n\n## 3. Setup Environment Variables\n\nCreate a `.env.local` file in the root directory.\n\n---\n\n# 🔐 Environment Variables\n\n```env\n# Clerk\n\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=\n\nCLERK_SECRET_KEY=\n\nNEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in\n\nNEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up\n\n━━━━━━━━━━━━━━━━━━━━\n\n# Liveblocks\n\nNEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY=\n\nLIVEBLOCKS_SECRET_KEY=\n\n━━━━━━━━━━━━━━━━━━━━\n\n# Trigger.dev\n\nTRIGGER_PROJECT_REF=\n\nTRIGGER_SECRET_KEY=\n\n━━━━━━━━━━━━━━━━━━━━\n\n# Database\n\nDATABASE_URL=\n\n━━━━━━━━━━━━━━━━━━━━\n\n# Blob Storage\n\nBLOB_READ_WRITE_TOKEN=\n\n━━━━━━━━━━━━━━━━━━━━\n\n# Google AI\n\nGOOGLE_AI_API_KEY=\n\n# Optional\nGEMINI_MODEL=\n\nGEMINI_SPEC_MODEL=\n\n━━━━━━━━━━━━━━━━━━━━\n\nAPP_URL=http://localhost:3000\n```\n\n---\n\n## 4. Setup Prisma\n\n```bash\nnpx prisma generate\n\nnpx prisma migrate dev\n```\n\n---\n\n## 5. Run Development Server\n\n```bash\nnpm run dev\n```\n\nOpen:\n\n```txt\nhttp://localhost:3000\n```\n\n---\n\n## 6. Start Trigger.dev Worker\n\nOpen a second terminal:\n\n```bash\nnpx trigger.dev@latest dev\n```\n\n---\n\n# 🎯 Core AI Workflow\n\n## Step 1 — User Prompt\n\nUser submits a natural language architecture request.\n\nExample:\n\n```txt\nBuild a scalable SaaS backend with Redis,\nPostgreSQL, authentication, and microservices\n```\n\n---\n\n## Step 2 — Trigger.dev Background Task\n\nA long-running background workflow is triggered.\n\n---\n\n## Step 3 — Gemini AI Tool Calling\n\nGemini AI receives:\n\n- system prompts\n- canvas context\n- available architecture tools\n\nAI generates structured actions like:\n\n```json\n{\n  \"tool\": \"addNode\",\n  \"input\": {\n    \"label\": \"API Gateway\"\n  }\n}\n```\n\n---\n\n## Step 4 — Liveblocks Sync\n\nCanvas state updates are broadcast in real time to all connected users.\n\n---\n\n## Step 5 — Technical Spec Generation\n\nThe final architecture graph is transformed into a detailed Markdown technical document.\n\n---\n\n# ⚡ Performance Optimizations\n\n- Debounced canvas auto-save\n- Background AI workflows\n- Blob-based specification storage\n- Incremental realtime updates\n- Shared collaborative state synchronization\n- Optimized React Flow rendering\n\n---\n\n# 🧪 Future Improvements\n\n- [ ] AI diff previews before applying changes\n- [ ] Canvas version history\n- [ ] Multiplayer commenting\n- [ ] Voice-based architecture generation\n- [ ] AI architecture recommendations\n- [ ] Dockerized deployment\n- [ ] Kubernetes deployment templates\n- [ ] Testing suite (Vitest + Playwright)\n- [ ] Prompt injection protection\n- [ ] Rate limiting \u0026 abuse prevention\n\n---\n\n# 🤝 Contributing\n\nContributions are welcome!\n\n## Steps\n\n```bash\n1. Fork the repository\n2. Create your feature branch\n3. Commit your changes\n4. Push to GitHub\n5. Open a Pull Request\n```\n\n---\n\n# 👨‍💻 Author\n\n## V S Santhosh\n\n- 🌐 Portfolio: [https://santhosh-vs-portfolio.vercel.app](https://santhosh-vs-portfolio.vercel.app)\n- 💼 LinkedIn: [https://linkedin.com/in/thesanthoshvs](https://linkedin.com/in/thesanthoshvs)\n- 🐙 GitHub: [https://github.com/Itssanthoshhere](https://github.com/Itssanthoshhere)\n\n---\n\n# 📜 License\n\nThis project is licensed under the MIT License.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### ⭐ If you found this project interesting, consider giving it a star!\n\nBuilt with ❤️ by Itssanthoshhere\n\n\u003c/div\u003e\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitssanthoshhere%2Fghost-arc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitssanthoshhere%2Fghost-arc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitssanthoshhere%2Fghost-arc/lists"}