Stable version.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
engine Marked as 2.0.0 Jan 15, 2018
.htaccess Updates from @mecha-cms/genome Dec 4, 2017
composer.json Updates from @mecha-cms/genome Dec 4, 2017

Mecha CMS

Mecha is a flat-file content management system with no dependencies.

Download Learn


At a Glance

Control Panel

Requires panel extension.



The default shield for Mecha version 2.x.x.



Mecha is a file-based CMS that survives on principle that a database-less site should be personal, portable, light and easy to be exported and backed up. That’s why most of the projects associated with Mecha are created with personal natures and are dedicated to be used for personal purposes such as blog, journal and diary. Mecha’s market shares are people with high creativity and individuals who want to dedicate themselves to the freedom of speech, that probably don’t have much time to learn web programming languages. By introducing Mecha as files and folders that used to be seen by people everyday in their working desktop, we hope you will soon be familiar with the way Mecha CMS works.

Mecha is as simple as files and folders. Yet, that doesn’t mean that Mecha is weak. Mecha has fairly flexible set of API that you can use without having to make it bloated, keeping you happy focused on developing your own site, according to your personality.

If you want to make something that is super huge with Mecha, that would be possible, but remember that Mecha wasn’t created to replace databases. Mecha was previously created simply to help people getting rid of various resources that are not needed from the start (such as databases). There will be a time when you need a database, and when that time comes, just use a database. Mecha is fairly open to be extended with other database-based applications.


  • Writing pages with ease using Markdown.
  • Unlimited page children.
  • Unlimited page fields.
  • Extensible as hell.
  • Create unique design for each blog post by adding special CSS and JavaScript files using the art plugin.
  • Built-in commenting system using the comment extension.
  • Almost everything are optional.
  • RSS and Sitemap using the feed extension.
  • Easy to use and well documented API.
  • Control panel extension.


  • PHP 5.6 and above, with enabled curl and mbstring extension.
  • Apache 2.4 and above, with enabled mod_rewrite module.


  1. Make sure that you already have the required components.
  2. Download the available package from the home page.
  3. Upload Mecha through your FTP/SFTP to the public folder/directory on your site, then extract it!
  4. Take a look on the available extensions and plugins that you might be interested.
  5. Upload your extension folders to lot\extend and your plugin folders to lot\extend\plugin\lot\worker. They’re auto-loaded.
  6. Read on how to add pages and tags. Learn on how to create pages from the author by looking at the source code.
  7. Install the panel extension if you are stuck by doing everything manually. You always have the full control to remove this extension without having to worry that your site will stop running after doing so.