Mishka CMS
An open source real-time CMS for Elixir and Phoenix LiveView. One install runs many websites.
Website · Documentation · Admin preview · Discord · Hire us
📖 What is Mishka CMS?
Mishka CMS is an open source real-time CMS built on Elixir, Phoenix LiveView and the Ash framework. You build pages in the browser, publish them without a redeploy, and run many websites from one install.
This repository is the application that runs it: the Phoenix endpoint, the router, the release scripts and the Dockerfile. The engine and the extensions are packages it loads from Hex.
✨ Why Mishka CMS
- 🌐 Many websites, one install: each brand, client or market gets its own site with its own domain, languages, users and content. One master account runs them all.
- 🎨 Visual page builder: place sections and components on a live canvas, edit text in place and check every screen size. The code behind the page is one click away.
- ⚡ Publish without a redeploy: pages, layouts and components live in the database and compile while the app runs. Visitors with the page open get the new styles at once.
- 📝 Drafts and versions: your work saves to a draft, teammates review it from a link, and every earlier version can be restored.
- 🔍 SEO with no setup: every page ships with its title, description, canonical link, social preview and structured data, and pages without an image get a share card drawn for them. Each site has its own sitemap and robots.txt.
- 🌍 Every language you publish in: one site serves several languages, with addresses like
/fa/blog, translated pages and interface words, and dates and numbers in each language's own format.
- 🔐 Secure sign-in: passwords or emailed sign-in links, two-step sign-in with an authenticator app, rate limits, and a captcha from Cloudflare Turnstile, Google reCAPTCHA or hCaptcha.
- 🛡️ Permissions you can read: names like
admin:dashboard:blog:post, with wildcards, kept apart for the dashboard and the API. Lock a page or a post to members.
- 🔌 Headless, coupled or both: a site serves its own pages, a JSON:API for your frontend, or both. The API comes with an OpenAPI spec and Swagger UI.
- 🧩 Plugins instead of forks: every action fires a named event such as
blog:comment:after_create, and your plugin hooks in by priority.
- 🧱 Components and UI kits: install a kit of ready components, write your own, and reuse snippets and design tokens across a site.
- 🧰 Everything a site needs: a media library, forms, redirects, email delivery and an activity log of every change.
- 🤖 Bring your own AI model: connect a model to the editor's Assistant with one Elixir module, and undo its edits like your own.
🚀 Get started
Follow Install Mishka CMS and sign in, then build your first site and start a blog. In short, with Elixir 1.20 or newer, PostgreSQL and bun:
git clone https://github.com/mishka-group/mishka_cms.git && cd mishka_cms
mix deps.get && mix assets.setup
mix ecto.create && mix oban.install --yes
mix ash.codegen cms_with_extensions && mix ash.migrate
mix assets.build && mix phx.server
Open http://localhost:4000, and the install wizard creates the master admin and the first site. mix run priv/repo/dev_seeds.exs fills a development database with sample sites and content. Without a local Elixir or PostgreSQL, use the development container in examples/docker.
🧪 Try the demo image
docker pull ghcr.io/mishka-group/mishka_cms-demo:0.0.2
demo-docker-compose.yml starts it with PostgreSQL 18 and explains the secrets. Open /install?token=... with your MISHKA_SETUP_TOKEN. The demo is for trying only: its migrations belong to one release, so a newer demo needs a fresh database.
🚢 Deploy
A real install is your own copy of this repository, built with its Dockerfile.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
