Skip to content

BlogposterCMS/BlogposterCMS

Repository files navigation

Tests
ALPHA status

⚠️ Version 0.7 – Breaking Changes Ahead
This release will break existing setups.

BlogposterCMS

The Composable Sandbox for Building Websites Without Chains

Forget monolithic CMS. Think modular freedom – with a builder that will one day make Canva jealous.


The Mission

BlogposterCMS isn’t just another CMS. It’s a composable platform built for creators, developers, and teams who want full control without bloat. The endgame? A system that’s as intuitive as a design tool, as flexible as a developer’s sandbox, and as future-proof as microservices – all without the lock-in nonsense.


Key Features (and why they matter)

  • Composable & Modular Load only what you need. Keep your project lean, your code clean, and your sanity intact.

  • Secure by Design Built-in sandboxing, granular permissions, and JWT-secured events. Because “ship now, patch later” isn’t a strategy – it’s a lawsuit waiting to happen.

  • Visual Builder with CanvasGrid (Alpha) Place responsive widgets exactly where you want them. The UX is “usable” now – aiming for Canva-level fluidity.

  • Workspace-Driven Navigation Organize pages by workspace with dynamic headers, quick-create panels, and nested subpages for sane site structure.

  • Static Export & Media Manager (Alpha) Publish builder designs as static HTML/CSS/JS and manage assets safely in the media library.

  • Database Freedom PostgreSQL, MongoDB, SQLite – pick your weapon. No “our way or the highway” here.

  • AI & Microservice Ready Extend with your own AI workflows or run modules as microservices. Future you will thank present you.

  • Performance + SEO Lightning-fast output with solid SEO. No dark rituals required for page speed.


Where We’re Going

Blogposter is moving towards becoming the Figma for websites:

  • A drag-and-drop builder that’s fast, fluid, and fun.
  • A secure, extensible backend that doesn’t choke under scale.
  • A marketplace for widgets, templates, and full site kits.
  • Deployment options from self-hosted to fully managed.

The goal is simple: own your content, own your stack, own your future.


Current Status (v0.7 Alpha)

This is the part of the movie where the lab is still smoking and someone says, “Technically it works.” Expect broken layouts, screaming logs and the occasional “Why is this on fire?”. If that sounds fun: grab a helmet and jump in. If you prefer boring things like “stable” and “predictable”, check back after a few releases


🛠 Quickstart

git clone https://github.com/BlogposterCMS/BlogposterCMS
cd BlogposterCMS
npm install
npm run build
cp env.sample .env
> Replace every placeholder in `.env` with a strong, unique secret before booting the stack to avoid deploying with default credentials. See the detailed requirements in [`docs/developer_quickstart.md`](docs/developer_quickstart.md) or [`docs/installation.md`](docs/installation.md).
npm start

After the server boots, complete the mandatory first-run setup to unlock the CMS:

  1. Open http://localhost:3000/install in your browser and finish the wizard to create the initial admin user.
  2. Once the wizard confirms completion, visit http://localhost:3000/admin to access the dashboard.

You must complete this flow before the CMS becomes available. For a more detailed walkthrough, see the installation guide.

CLI coming soon to save you from manual setup.


Docs & Dev Guide

Full docs in docs/index.md. Sample module: modules/dummyModule.


Join the Build

Frontend wizards, UI/UX magicians, and module tinkerers – BlogposterCMS is an open playground. Help us make it the CMS we all wish existed.


Support

If you like the direction, buy me a coffee. It funds both code and caffeine overdoses. Buy Me A Coffee


📝 License

MIT – use at your own risk. LICENSE