{"id":46576644,"url":"https://github.com/zebbern/devonz","last_synced_at":"2026-03-07T10:04:33.165Z","repository":{"id":334442243,"uuid":"1138647572","full_name":"zebbern/Devonz","owner":"zebbern","description":"Devonz the open source vibe coding platform adopted from bolt.diy now newer, faster and done with a twist!","archived":false,"fork":false,"pushed_at":"2026-02-16T11:55:12.000Z","size":11651,"stargazers_count":16,"open_issues_count":4,"forks_count":13,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-16T20:19:48.527Z","etag":null,"topics":["ai-generator","ai-powered","ai-website-builder","ai-website-generator","vibe-coding","vibe-platform","website-builder","website-clone","website-design","website-development","website-generation"],"latest_commit_sha":null,"homepage":"","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/zebbern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","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-01-21T00:04:53.000Z","updated_at":"2026-02-16T11:55:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zebbern/Devonz","commit_stats":null,"previous_names":["zebbern/devonz"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zebbern/Devonz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2FDevonz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2FDevonz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2FDevonz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2FDevonz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zebbern","download_url":"https://codeload.github.com/zebbern/Devonz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2FDevonz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30212021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T09:02:10.694Z","status":"ssl_error","status_checked_at":"2026-03-07T09:02:08.429Z","response_time":53,"last_error":"SSL_read: 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":["ai-generator","ai-powered","ai-website-builder","ai-website-generator","vibe-coding","vibe-platform","website-builder","website-clone","website-design","website-development","website-generation"],"created_at":"2026-03-07T10:04:32.581Z","updated_at":"2026-03-07T10:04:33.159Z","avatar_url":"https://github.com/zebbern.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg width=\"236\" height=\"79\" alt=\"devonz\" src=\"https://github.com/user-attachments/assets/30c464d9-39a9-4c0d-85f8-64473cfa774c\" /\u003e\n\n**AI-powered full-stack development agent :-: describe what you want, watch it build.**\n\n[![Docker Build](https://img.shields.io/github/actions/workflow/status/zebbern/Devonz/ci.yml?branch=main\u0026label=Docker%20Build\u0026logo=docker)](https://github.com/zebbern/Devonz/actions/workflows/ci.yml)\n[![Node](https://img.shields.io/badge/Node-18.18%2B-339933?logo=nodedotjs\u0026logoColor=white)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-3178C6?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n\n[Features](#features) ━━ [Installation](#installation) ━━ [Configuration](#configuration)\n\n[Docker](#docker) ━━ [Scripts](#scripts) ━━ [Keeping Up to Date](#keeping-up-to-date) \n\n[Project Structure](#project-structure) ━━ [Contributing](#contributing) ━━ [Acknowledgments](#acknowledgments)\n\n![Devonz Screenshot](https://github.com/user-attachments/assets/e4c3067d-2539-4b5e-abab-d129d90b51dc)\n\n\u003c/div\u003e\n\n\n## Quick Start\n\n**Docker** (recommended):\n\n```bash\ndocker compose up -d\n# Open http://localhost:5173\n```\n\n**From source**:\n\n```bash\ngit clone https://github.com/zebbern/Devonz.git \u0026\u0026 cd Devonz\npnpm install\npnpm run dev\n# Open http://localhost:5173\n```\n\n\u003e First load can take up to 2 minutes while dependencies compile.\n\n---\n\n## Why Devonz?\n\n- **22 AI providers** — OpenAI, Anthropic, Google, Groq, Z.ai, Ollama, and more. Swap models mid-conversation.\n- **Full dev environment** — editor, terminal, live preview, powered by a local Node.js runtime.\n- **One-click deploy** — push to GitHub, GitLab, Netlify, or Vercel directly from the UI.\n- **MCP tools** — extend the agent with Model Context Protocol servers for specialized workflows.\n- **Auto-fix** — terminal error detection catches failures and patches them automatically.\n- **Image context** — attach screenshots or design files to prompts for visual understanding.\n- **Design Palette** — pick custom color themes that get injected into AI-generated apps.\n- **3D support** — generate React Three Fiber apps with automatic version pinning and peer dependency resolution.\n- **Template gallery** — start from popular frameworks and boilerplates, then customize with AI.\n- **State-of-the-art AI SDK** — built on the Vercel AI SDK for best-in-class LLM performance and reliability.\n\n---\n\n## Features\n\n**AI \u0026 Code Generation**\n- Natural language to full-stack apps (Node.js-based)\n- 22 LLM providers with hot-swappable model selection\n- MCP (Model Context Protocol) tool integration\n- Automatic error detection and auto-fix from terminal output\n- Attach images to prompts for visual context\n- **Extended Thinking** — AI reasoning visualization for Anthropic Claude and Google Gemini\n- **MCP Schema Sanitization** — Automatic schema compatibility for Google Gemini (strips unsupported constructs)\n- **MCP Auto-Approve** — Per-server auto-approve toggle for trusted MCP servers\n- **Formatted Tool Results** — MCP tool results render as formatted markdown instead of raw JSON\n- **Design Palette** — UI for picking custom color themes injected into generated code\n- **3D App Generation** — React Three Fiber support with automatic version pinning for React 18/19\n\n**Development Environment**\n- In-browser code editor (CodeMirror) with syntax highlighting\n- Integrated terminal (xterm.js) with full shell access\n- Real-time application preview\n- Diff view for AI-generated changes\n- File locking to prevent conflicts during generation\n\n**Security \u0026 Reliability**\n- **Security Hardened** — `withSecurity()` on all 42 API routes with input validation, rate limiting options, URL allowlisting\n\n**Deployment \u0026 Integrations**\n- GitHub / GitLab push and repo management\n- Netlify and Vercel one-click deploy\n- Supabase database integration\n- Git version control built-in\n- Template gallery with category filtering, search, live preview, and one-click cloning\n\n---\n\n## Installation\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFrom Source (Node.js)\u003c/strong\u003e\u003c/summary\u003e\n\n**Prerequisites**: Node.js 18.18+ and pnpm (latest)\n\n```bash\ngit clone https://github.com/zebbern/Devonz.git\ncd Devonz\npnpm install\npnpm run dev\n```\n\nOpen [http://localhost:5173](http://localhost:5173).\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDocker\u003c/strong\u003e\u003c/summary\u003e\n\nNo Node.js required. Just Docker.\n\n```bash\n# Option 1: Docker Compose (pulls from GHCR)\ndocker compose up -d\n\n# Option 2: Build locally\ndocker build -t devonz .\ndocker run --rm -p 5173:5173 --env-file .env.local devonz\n```\n\nOpen [http://localhost:5173](http://localhost:5173).\n\n\u003c/details\u003e\n\n---\n\n## Configuration\n\nCopy the example env file and add your API keys:\n\n```bash\ncp .env.example .env.local\n```\n\nOr use the interactive setup wizard (can init `.env.local`, sync `.env` for Docker, and prompt for keys with hidden input):\n\n```bash\npnpm run setup\n```\n\n```bash\n# AI Provider API Keys (add any you use)\nOPENAI_API_KEY=your_openai_key\nANTHROPIC_API_KEY=your_anthropic_key\nGOOGLE_GENERATIVE_AI_API_KEY=your_google_key\nZAI_API_KEY=your_zai_key\n\n# Local Provider URLs (optional)\nOLLAMA_API_BASE_URL=http://127.0.0.1:11434\n\n# Deployment Tokens (optional — can also be set via UI)\nVITE_GITHUB_ACCESS_TOKEN=your_github_token\nVITE_NETLIFY_ACCESS_TOKEN=your_netlify_token\n```\n\nYou can also configure providers in-app: **Settings (gear icon) → Providers tab**.\n\nSee [.env.example](.env.example) for all available variables.\n\n---\n\n## Docker\n\n```bash\npnpm docker:build          # Build image locally\npnpm docker:run            # Run standalone container\npnpm docker:up             # Start via Docker Compose\npnpm docker:down           # Stop services\npnpm docker:dev            # Dev mode with hot reload\npnpm docker:update         # Pull latest image + restart\n```\n\n**Auto-update with Watchtower** (polls GHCR every 5 minutes):\n\n```bash\ndocker compose --profile auto-update up -d\n```\n\n---\n\n## Scripts\n\n```bash\n# Development\npnpm run dev               # Start dev server\npnpm run build             # Production build\npnpm run start             # Run production build\npnpm run preview           # Build + preview locally\n\n# Quality\npnpm test                  # Run test suite\npnpm test:watch            # Tests in watch mode\npnpm run typecheck         # TypeScript type check\npnpm run lint              # ESLint check\npnpm run lint:fix          # Auto-fix lint issues\n\n# Utilities\npnpm run clean             # Clean build artifacts\npnpm run update            # Pull latest + install + rebuild\n```\n\n---\n\n## Keeping Up to Date\n\n**Git clone users:**\n\n```bash\npnpm run update                    # pulls, installs deps, rebuilds\npnpm run update -- --skip-build    # pull + install only\n```\n\n**Docker users:**\n\n```bash\npnpm docker:update                 # pulls latest image, restarts\n```\n\n**Hands-free (Watchtower):**\n\n```bash\ndocker compose --profile auto-update up -d\n```\n\n---\n\n## Project Structure\n\n\u003cdetails\u003e\n\u003csummary\u003eExpand file tree\u003c/summary\u003e\n\n```\ndevonz/\n├── app/\n│   ├── components/         # React components (10 groups)\n│   │   ├── @settings/      # Settings panel (14 tabs)\n│   │   ├── chat/           # Chat interface\n│   │   ├── deploy/         # Deployment integrations\n│   │   ├── editor/         # Code editor (CodeMirror)\n│   │   ├── git/            # Git integration\n│   │   ├── header/         # App header\n│   │   ├── sidebar/        # Sidebar navigation\n│   │   ├── templates/      # Template gallery\n│   │   ├── ui/             # 40+ shared UI components\n│   │   └── workbench/      # Development workbench\n│   ├── lib/\n│   │   ├── .server/        # Server-only code (LLM streaming)\n│   │   ├── agent/          # Agent prompts + orchestration\n│   │   ├── common/         # Prompt library + shared prompts\n│   │   ├── hooks/          # 25 custom React hooks\n│   │   ├── modules/        # Feature modules (22 LLM providers)\n│   │   ├── persistence/    # IndexedDB, localStorage, autoBackup\n│   │   ├── runtime/        # Action runner, message parser, local runtime\n│   │   ├── services/       # API services\n│   │   ├── stores/         # 24 nanostores\n│   │   └── utils/          # Service-level utilities\n│   ├── routes/             # 48 Remix routes (6 pages + 42 API)\n│   ├── styles/             # Global styles (SCSS + CSS)\n│   └── types/              # TypeScript type definitions\n├── docs/                   # Extended documentation\n└── scripts/                # Build \u0026 update scripts\n```\n\n\u003c/details\u003e\n\n---\n\n## Tech Stack\n\n**Remix** + **Vite** + **TypeScript** · **UnoCSS** · **Radix UI** · **Framer Motion** · **Vercel AI SDK** · **CodeMirror** · **xterm.js** · **Local Runtime (host Node.js)**\n\n---\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/my-feature`\n3. Commit changes: `git commit -m 'feat: add my feature'`\n4. Push: `git push origin feature/my-feature`\n5. Open a Pull Request\n\nSee [CONTRIBUTING.md](docs/CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## Acknowledgments\n\n- [bolt.diy](https://github.com/stackblitz-labs/bolt.diy) — original project foundation\n- Originally based on [StackBlitz bolt.new](https://github.com/stackblitz-labs/bolt.diy). Now uses a local Node.js runtime for code execution.\n- [Vercel AI SDK](https://sdk.vercel.ai/) — AI capabilities\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eBuild anything with AI. Just describe what you want.\u003c/strong\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003ca href=\"https://github.com/zebbern/Devonz\"\u003eGitHub\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/zebbern/Devonz/issues\"\u003eIssues\u003c/a\u003e ·\n  \u003ca href=\"docs/\"\u003eDocumentation\u003c/a\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fdevonz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzebbern%2Fdevonz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fdevonz/lists"}