{"id":49410498,"url":"https://github.com/patrykiti/coderso","last_synced_at":"2026-05-31T20:00:44.125Z","repository":{"id":354516889,"uuid":"1141712777","full_name":"PatrykIti/Coderso","owner":"PatrykIti","description":"A modular CMS and web platform built with Bun and React — simple for creators, powerful for developers.","archived":false,"fork":false,"pushed_at":"2026-05-29T21:57:33.000Z","size":56530,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T22:02:39.189Z","etag":null,"topics":["bun","cms","modular","plugins","react","web-platform"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PatrykIti.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","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-01-25T09:44:09.000Z","updated_at":"2026-05-04T21:12:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"93ff3642-d4ee-4b25-97e8-b5bae58779ed","html_url":"https://github.com/PatrykIti/Coderso","commit_stats":null,"previous_names":["patrykiti/coderso"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/PatrykIti/Coderso","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatrykIti%2FCoderso","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatrykIti%2FCoderso/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatrykIti%2FCoderso/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatrykIti%2FCoderso/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PatrykIti","download_url":"https://codeload.github.com/PatrykIti/Coderso/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PatrykIti%2FCoderso/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33746513,"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-05-31T02:00:06.040Z","response_time":95,"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":["bun","cms","modular","plugins","react","web-platform"],"created_at":"2026-04-29T00:03:16.719Z","updated_at":"2026-05-31T20:00:44.117Z","avatar_url":"https://github.com/PatrykIti.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./.github/banner.png\" alt=\"Coderso — the modern, AI-native website platform\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eThe modern, AI-native alternative to WordPress.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Build real websites, content systems, and business apps — visually, with structured data underneath\n  \u003cbr /\u003e\n  and a built-in AI assistant that helps you set it all up.\n  \u003cbr /\u003e\n  \u003cem\u003eSimple on the surface. Powerful underneath. No rebuilds to ship a change.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-why-coderso\"\u003eWhy Coderso\u003c/a\u003e\n  ·\n  \u003ca href=\"#-coderso-vs-wordpress\"\u003evs WordPress\u003c/a\u003e\n  ·\n  \u003ca href=\"#-features\"\u003eFeatures\u003c/a\u003e\n  ·\n  \u003ca href=\"#-the-ai-assistant\"\u003eAI Assistant\u003c/a\u003e\n  ·\n  \u003ca href=\"#-quick-start\"\u003eQuick Start\u003c/a\u003e\n  ·\n  \u003ca href=\"#-documentation\"\u003eDocs\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"License\" src=\"https://img.shields.io/badge/license-Apache--2.0-blue.svg\" /\u003e\n  \u003cimg alt=\"Runtime\" src=\"https://img.shields.io/badge/runtime-Bun-black.svg\" /\u003e\n  \u003cimg alt=\"UI\" src=\"https://img.shields.io/badge/UI-React%2019-149eca.svg\" /\u003e\n  \u003cimg alt=\"Database\" src=\"https://img.shields.io/badge/db-PostgreSQL-336791.svg\" /\u003e\n  \u003cimg alt=\"Status\" src=\"https://img.shields.io/badge/status-active%20development-success.svg\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 👋 What is Coderso?\n\n**Coderso** is a modular web platform with the everyday simplicity of WordPress and the architecture\nof a modern, developer-first app. You get pages, posts, media, menus, forms, SEO, and a visual\nbuilder out of the box — plus a content engine, business modules, runtime plugins, and a built-in\n**AI assistant** that can guide setup and even make changes for you.\n\nIt is designed to **start simple**…\n\n- create pages and posts,\n- manage media,\n- build forms,\n- configure menus and SEO,\n- publish — instantly.\n\n…and **grow without limits**:\n\n- custom content models for real business data,\n- reusable widgets and templates,\n- listings, search, booking, reviews, and commerce,\n- runtime plugins installed without rebuilding the app,\n- one-click **Solution Kits** for whole verticals,\n- an AI assistant that plans and applies changes.\n\n\u003e Coderso is pronounced **ko-der-so** — *Code + Resources*, *Code + Orchestrator*.\n\n---\n\n## ✨ Why Coderso\n\n### 🤖 AI-native, not AI-bolted-on\nMost platforms staple a chatbot on top. Coderso ships an assistant that actually **understands the\nproduct** and can **execute typed, reviewable actions** (create a content type, build a page, set up a\nform) through a safe `plan → dry-run → review → execute → validate` flow. It works **with no API key\nat all** thanks to a built-in documentation engine — and gets supercharged when you plug in your own\nLLM provider.\n\n### ⚡ Change things live — no rebuilds, no downtime\nEditing content, settings, menus, themes, security policy, or installing a plugin **never requires a\nserver restart or a rebuild**. It's the fast, edit-and-refresh feel of classic PHP — but with a modern,\ntyped, validated runtime. You only rebuild when you change the core source itself.\n\n### 🧱 Visual on top, structured underneath\nCompose pages from reusable **widgets** with a visual builder, while everything stays as clean,\nvalidated, structured data. Non-technical users build comfortably; developers keep guarantees.\n\n### 🔌 Extend without forking\nA **runtime plugin system** lets you ship extensions as prebuilt bundles — installed, upgraded, and\nrolled back live. A dedicated **store** workspace adds curation and security scanning on top.\n\n### 🛡️ Secure and tested by default\nSchema-first validation, RBAC, CSRF, rate limiting, encrypted secrets, audit logs, and built-in\nsecurity scanners (Semgrep, Trivy, Gitleaks) plus release gates — baked into the workflow, not an\nafterthought.\n\n---\n\n## 🥊 Coderso vs WordPress\n\n| | **WordPress** | **Coderso** |\n|---|---|---|\n| Core language / runtime | PHP | **Bun + TypeScript**, end-to-end typed |\n| Admin UI | Server-rendered + jQuery legacy | **React 19 + Tailwind**, modern SPA admin |\n| Content modeling | Plugins (ACF, etc.) | **Built-in content engine** (custom types, entries, screens) |\n| Page building | Plugin-dependent (Elementor/Gutenberg) | **Native visual builder** with validated widget data |\n| Data integrity | Loosely-typed meta tables | **Schema-first**, validated, normalized |\n| Extending | Plugins (often need rebuild/cache flush) | **Runtime plugins** — install/upgrade/rollback live |\n| AI | Third-party add-ons | **Native assistant** (docs-only or LLM-powered) |\n| Business modules | Many separate plugins | **Forms, Listings, Booking, Reviews, Commerce, Popups** in one place |\n| Verticals | DIY or premium themes | **Solution Kits** — one-click setups |\n| Security | Plugin sprawl, frequent CVEs | **Hardened core** + scanners + release gates |\n| Restart to apply changes | Rarely (but cache/plugin chaos) | **Never** for content/config/plugins |\n\n\u003e Coderso isn't trying to *be* WordPress. It's what a content platform looks like when you design it\n\u003e today — for creators, operators, **and** developers.\n\n---\n\n## 🧩 Features\n\n### Publish (familiar, fast)\n- **Pages** with draft/published workflow, revisions, and tokenized draft previews\n- **Posts** with a block-based, Gutenberg-class writing editor (smart paste, autosave, TOC)\n- **Media library** (local filesystem or S3/Azure), with alt/title/caption metadata\n- **Menus** with nesting, locations, and draft/publish lifecycle\n- **SEO manager**, redirects, and per-page metadata\n\n### Build (compose anything)\n- **Visual page builder** with a categorized widget library\n- **Widgets \u0026 templates** — composite-first, beginner-friendly, fully validated\n- **Content Engine** — define custom content types and collections (no table migrations)\n- **Custom Screens** — purpose-built admin screens bound to your data\n\n### Run your business\n- **Forms** with multi-step flows and automation (email, webhook, entry sync, redirect)\n- **Listings, Filters \u0026 Search** — dynamic, query-driven content surfaces\n- **Booking** — resources, services, schedules, reservations\n- **Reviews** \u0026 **Popups** for engagement\n- **Commerce** — product galleries, comparison, tables, and a pluggable checkout/cart\n\n### Grow\n- **Solution Kits** — install a whole vertical in one flow (automotive workshop, beauty salon,\n  medical clinic, services directory, small e-commerce)\n- **AI Site Wizard** — guided `profile → goals → recommendation → review → execute`\n- **Themes \u0026 design tokens** with multiple visual profiles\n\n### Extend\n- **Runtime plugin system** with a strict manifest contract and safe scoped routes\n- **Plugin SDK** for building extensions\n- **Store** workspace for distribution, curation, and security scanning\n\n### Operate \u0026 secure\n- **Roles \u0026 permissions (RBAC)**, sessions, 2FA, API keys, webhooks, integrations\n- **Audit logs**, login alerts, IP allowlist, backups, import/export\n- **Dashboard** with KPIs, recent edits, and a live security status panel\n\n\u003e Coderso is under active development. Core publishing is stable; many business and growth modules\n\u003e ship as **Beta**, and a few (multi-language, member portal, mega menu) are on the roadmap.\n\n---\n\n## 🤖 The AI Assistant\n\nCoderso has **two assistant modes**, and the first one needs **zero configuration**:\n\n1. **Docs Assistant (no API key required).** A deterministic retrieval engine answers product\n   questions from a built-in documentation corpus. This is the \"documentation logic underneath\" that\n   helps users find their way without any external service.\n2. **LLM Guide (bring your own provider).** Plug in an OpenAI or OpenRouter key (stored encrypted in\n   Integrations) and the assistant can **plan and apply real changes** through strict, typed actions —\n   always behind a `plan → dry-run → review → execute → validate` flow, with RBAC and idempotency.\n\nThe Docs Assistant's knowledge lives in [`docs/guide/`](docs/guide/) and is re-indexed on demand.\nWant to teach the assistant something new? Add a Markdown page there — see\n[**Extending the assistant**](docs/develop/assistant.md).\n\n---\n\n## ⚡ The No-Restart Runtime\n\nThis is Coderso's signature. Most of what you change applies **live**:\n\n| ✅ Live — no restart | 🔧 Needs a rebuild |\n|---|---|\n| Content, pages, posts, menus | Changes to **core source** (the app itself) |\n| Site \u0026 business settings | (rebuilt in CI to `dist/client` + `dist/server`) |\n| Themes \u0026 design tokens | |\n| Security middleware (CORS / CSRF / rate-limit / headers) | |\n| Plugins — install, upgrade, rollback (runtime ESM bundles) | |\n| Assistant configuration | |\n\nEnvironment variables are reserved for **critical infrastructure only** (e.g. `DATABASE_URL`, media\nmaster key). Everything operational is configured from the admin UI and applied at runtime.\n\nRead more in [**The No-Restart Runtime**](docs/develop/runtime-model.md).\n\n---\n\n## 🚀 Quick Start\n\n\u003e Prerequisites: [**Bun**](https://bun.sh) and a **PostgreSQL** database.\n\n```bash\n# 1. Clone\ngit clone https://github.com/PatrykIti/Coderso.git\ncd Coderso\n\n# 2. Install dependencies\nbun install\n\n# 3. Configure environment\ncp .env.example .env    # set DATABASE_URL and the required secret keys\n\n# 4. Run database migrations\nbun run db:migrate\n\n# 5. Start the dev environment (core + store)\nbun run dev\n```\n\nRun a single workspace:\n\n```bash\nbun run dev:core     # core app only\nbun run dev:store    # store workspace only\n```\n\nOn first login you'll be guided through a short **Setup Wizard** (site name, locale, public URL,\nsession policy). Full walkthrough: [**Local Development Setup**](docs/develop/getting-started.md).\n\n---\n\n## 📚 Documentation\n\nCoderso keeps three clearly separated documentation homes:\n\n| Audience | Location | What it is |\n|---|---|---|\n| 🧑‍💻 **End users \u0026 operators** | [`docs/guide/`](docs/guide/) | How to *use* the product — also the AI assistant's knowledge corpus |\n| 🛠️ **Developers \u0026 contributors** | [`docs/develop/`](docs/develop/) | How to *develop, extend, and ship* Coderso |\n| 🤖 **Internal (AI agents)** | `_docs/` | Exhaustive specs, tasks, and changelog — deep reference, not required reading |\n\n### For users — [`docs/guide/`](docs/guide/)\n- [Getting started \u0026 admin orientation](docs/guide/getting-started/)\n- [Admin screens reference](docs/guide/screens/) — dashboard, media, pages, menus, SEO, users, security, and more\n- [Coderso modules](docs/guide/coderso/) — Engine, Forms, Listings, Booking, Commerce, Posts, Custom Screens…\n- [Solution Kits](docs/guide/solution-kits/) — automotive workshop, beauty salon, medical clinic, services directory, small e-commerce\n- [Playbooks](docs/guide/playbooks/) — lead generation, booking, commerce, content-first, and custom builds\n\n### For developers — [`docs/develop/`](docs/develop/)\n- [**Local Development Setup**](docs/develop/getting-started.md) — get running in minutes\n- [**Project Structure**](docs/develop/project-structure.md) — find your way around the repo\n- [**Architecture Overview**](docs/develop/architecture.md) — how the pieces fit\n- [**The No-Restart Runtime**](docs/develop/runtime-model.md) — the live-update model\n- [**Content Models \u0026 Widgets**](docs/develop/content-and-widgets.md) — model data, build blocks\n- [**Plugins, SDK \u0026 Store**](docs/develop/plugins-and-store.md) — extend without forking\n- [**The AI Assistant**](docs/develop/assistant.md) — how it works, how to extend it\n- [**Testing**](docs/develop/testing.md) — the Bun + Vitest lanes\n- [**Security for Developers**](docs/develop/security.md) — the rules that keep Coderso safe\n- [**Contributing Workflow**](docs/develop/contributing.md) — branches, commits, gates, releases\n- [**Adding a Change: End to End**](docs/develop/adding-a-change.md) — the golden path\n\nStart here: the **[documentation hub](docs/README.md)**.\n\n---\n\n## 🛠️ Tech Stack\n\n- **[Bun](https://bun.sh)** — runtime kernel and test execution\n- **[React 19](https://react.dev)** — admin UI\n- **[Vite](https://vite.dev)** — build pipeline\n- **[TypeScript](https://www.typescriptlang.org/)** — end-to-end typed code\n- **[Tailwind CSS](https://tailwindcss.com/)** + **[Radix UI](https://www.radix-ui.com/)** — styling and accessible primitives\n- **[Drizzle ORM](https://orm.drizzle.team/)** + **[PostgreSQL](https://www.postgresql.org/)** — data layer\n\nOrganized as a monorepo:\n\n```text\n.\n├── core        # the application: Bun runtime, React admin, public site, services, DB\n├── store       # plugin distribution + security pipeline\n└── packages    # shared packages (SDK, contracts)\n```\n\n---\n\n## 💚 Contributing\n\nCoderso welcomes contributions. Start with the\n[**Contributing Workflow**](docs/develop/contributing.md), then:\n\n- [Contributing guidelines](CONTRIBUTING.md)\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Support](SUPPORT.md)\n- [Security Policy](SECURITY.md)\n\nCode and code comments are written in English; documentation may be multilingual.\n\n---\n\n## 🧭 Vision\n\n\u003e **WordPress for everyone, with superpowers for developers — and an AI that actually helps.**\n\nA platform where non-technical users manage real websites comfortably, developers extend it into\ncustom products and business tools, and an AI assistant turns intent into safe, reviewable changes.\n\n---\n\n## 📄 License\n\n[Apache-2.0](LICENSE.md)\n\n## 📬 Contact\n\nEmail: **hello@coderso.dev**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrykiti%2Fcoderso","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatrykiti%2Fcoderso","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrykiti%2Fcoderso/lists"}