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.
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 ./
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/
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
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)
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
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.
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.”
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.
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
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
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
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.
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.
See live examples
Three real sites built by OpenAI, Claude, and Gemini from the same brief. Different results. All production-quality.
Deploy in two minutes
Apache and Nginx instructions side by side, the 5-step quickstart, and copy-paste migration commands on one page.
Read the full feature list
Every capability in detail: AI generation, caching layers, security defaults, blog module, roles, and the block editor.
GNU GPL v3 — Self-hosting fully permitted
View MonolithCMS source on GitHub →