How It Works

Upload. Visit. Done.

There are two paths: the developer path — upload one file and your site infrastructure creates itself — and the AI path — describe your project and get a complete, production-ready site in minutes. Both start with one file.

TERMINAL

$ scp index.php user@host:public_html/

$ curl https://yourdomain.com

✓ MonolithCMS 1.0.146 — setup wizard ready

CREATED AUTOMATICALLY

├── site.sqlite ✓ 29 migrations

├── .htaccess ✓ db protected

└── cache/ ✓ ready

Path 01

The Developer Path

From download to live site in under two minutes. No build step, no dependency install, no database to provision. Upload one file to a server with PHP and you are done.

01

Download index.php

The entire MonolithCMS application — ~18,629 lines of PHP — lives in one file. Download it from GitHub. That is the entire installation.

git clone https://github.com/agim/MonolithCMS
cp MonolithCMS/index.php ./

02

Upload to your host

FTP, SFTP, cPanel File Manager, rsync — however you move files to your server. Drop index.php into your public_html directory or document root. One file. That is it.

scp index.php user@host:public_html/

03

Visit your domain

Open your browser. The first HTTP request triggers self-creating infrastructure: site.sqlite is created, all 29 database migrations run in milliseconds, and .htaccess is written to disk blocking direct database access.

# Everything created automatically:
✓ site.sqlite — schema ready
✓ .htaccess — db protected
✓ cache/ — directories made

04

Run the setup wizard

A 4-step wizard launches automatically. Set your site name, admin email, and password. No database credentials to enter — there are none. The wizard completes in under a minute.

Step 1: Admin account
Step 2: Site name & tagline
Step 3: AI provider (optional)
Step 4: Email config (optional)

05

Your site is live

Log in to the admin panel. Create pages using the visual block editor, write blog posts, manage media, configure navigation, and add team members with role-based access. No restart required — ever.

yourdomain.com/admin
✓ admin, editor, viewer roles
✓ bcrypt cost 12 + MFA ready

bolt

Moving the site later

When it is time to move to a new host, migrate to staging, or hand off to a client — two commands move everything. Every page, post, user, setting, and media reference travels with two files.

cp index.php new-server/public_html/
cp site.sqlite new-server/public_html/

Path 02

The AI Site Generation Path

Describe your project in natural language. MonolithCMS sends it to OpenAI, Anthropic Claude, or Google Gemini — switchable from admin settings — and gets back a complete, designed, production-ready site. You review it before a single character touches your database.

01

Describe your project

In the admin panel, open the AI Site Generator. Write a natural-language brief: your brand name, your audience, the pages you need, your visual direction, colour preferences, and any copy you already have. The more you give, the better the output — but even a short paragraph produces a real site.

“Architecture firm targeting residential clients in the Pacific Northwest. Calm, professional tone. Dark hero with slate and off-white. Pages: Home, Portfolio, About, Contact. We care about sustainability and quiet design.”

02

Choose your AI provider

Select OpenAI, Anthropic Claude, or Google Gemini from the admin settings — no code changes, just a dropdown and your API key. Each provider uses a structured prompt engineered to produce full site plans: harmonised colour palettes with primary, secondary, accent, background, and text values all coordinated; fluid typography using CSS clamp() sizing; page-by-page block selection and ordering; and complete HTML and CSS for every section.

OpenAIAnthropic ClaudeGoogle Gemini
03

AI generates the full plan

MonolithCMS sends your brief to the AI and receives back a structured site plan covering every page. The plan defines the global colour palette, typographic scale, navigation structure, header, and footer — then page by page, it selects blocks, orders sections, and generates all the HTML and CSS content for each. No templates. No presets. Designed from first principles based on your brief.

# Plan output includes:
✓ colour palette — primary, secondary, accent, bg, text
✓ fluid typography with clamp() scale
✓ 4–8 blocks per page, ordered by purpose
✓ full HTML + CSS per block, no placeholders

04

Preview and edit the plan

The full-site preview renders every page in the browser before anything is written to the database. The plan is stored for review. You can approve the whole site, edit individual blocks that need adjusting, or regenerate a single page that missed the mark — without restarting the entire generation. Change a headline, swap a colour, rewrite a section. The rest of the plan stays intact.

APPROVE ALL

Writes all pages atomically

EDIT BLOCK

Change one section, keep the rest

REGEN PAGE

Re-run AI for one page only

05

Apply — one atomic write

When the plan looks right, click Apply. MonolithCMS writes all pages, theme settings, navigation structure, header, and footer to the SQLite database in a single atomic transaction. If anything fails mid-write, the transaction rolls back — your database is never left in a half-written state. The site goes live the moment the write completes. If you change your mind, reject the plan and it is gone — nothing was written.

BEGIN TRANSACTION;
INSERT pages, blocks, theme, nav...;
COMMIT; -- or ROLLBACK on error
✓ site.sqlite updated — site is live

06

Refine with the block editor

After apply, every block on every page is editable through the visual block editor. Add new sections, reorder existing ones, update copy, swap images, change colours. The AI-generated site is a starting point, not a locked artefact. You own every pixel and every line of content from the moment it is applied.

What runs on that first request

Before you have typed a single character in the setup wizard, MonolithCMS has already done a significant amount of work. Here is exactly what happens in the first milliseconds.

29

DB migrations run

Full schema created in milliseconds on first boot

1

.htaccess written

Blocks .sqlite, .db, .env, .log, .sh, .bak, .sql immediately

0

config files needed

No .env, no config.php, no database credentials to set

~18,629

lines of PHP

Zero frameworks, zero dependencies, one file

Self-creating infrastructure, in detail

MonolithCMS does not rely on you to configure security. Defense-in-depth is automatic, and it covers every environment.

Auto-generated .htaccess

On the very first HTTP request, MonolithCMS writes a .htaccess file that immediately denies direct browser access to .sqlite, .db, .env, .log, .sh, .bak, and .sql files. This happens before the setup wizard even loads. You cannot forget to do it. It is already done.

The same .htaccess enables clean URL routing — all requests are passed through index.php — so no Apache mod_rewrite configuration is needed on your end.

.htaccess (written automatically)

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

# Block sensitive files
<FilesMatch "\.(sqlite|db|env|log|sh|bak|sql)$">
  Require all denied
</FilesMatch>

Migration

Move any site in two commands

New server, new domain, staging environment, client handoff — it does not matter. The entire site is two files. Every page, every blog post, every media file reference, every user account, every revision, every setting. Copy two files. Done.

check_circleEvery page and block included
check_circleAll blog posts and drafts
check_circleAll user accounts and roles
check_circleAll site settings and theme config
check_circleAll media file references and metadata
check_circleFull revision history
See full deployment guide

TWO-FILE MIGRATION

# Step 1 — copy the application

cp index.php   new-server/public_html/

# Step 2 — copy the database

cp site.sqlite new-server/public_html/

THAT IS THE ENTIRE MIGRATION

✓  new server is live with full site history

Ready to see it for yourself?

Three live sites built entirely by AI — one per provider — demonstrate exactly what the generation engine produces. Or go straight to the deployment guide and be live in under two minutes.

explore

See live examples

Three real sites built by OpenAI, Claude, and Gemini from the same brief. Different results. All production-quality.

View example sites
rocket_launch

Deploy in two minutes

Apache and Nginx instructions side by side, the 5-step quickstart, and copy-paste migration commands on one page.

Open deployment guide
settings

Read the full feature list

Every capability in detail: AI generation, caching layers, security defaults, blog module, roles, and the block editor.

Explore all features

GNU GPL v3 — Self-hosting fully permitted

View MonolithCMS source on GitHub →