TYPEMILL is a lightweight flat file cms for micro-publishers. You can use it for documentations, manuals, special interest websites, and any other information-driven web-project. You can also enhance Typemill with plugins and generate professional e-books in pdf-format with it. The website http://typemill.net runs with Typemill.
- Website with markdown-files.
- Visual markdown editor (VUE.js) and raw markdown mode.
- Flexible drag & drop navigation.
- Markdown extras with
- table of contents (TOC)
- definition lists
- math (with plugin)
- figures with captions
- Media library with images and files.
- System configurations.
- User management.
- Flexible form management with YAML-files.
- Flexible access rights.
- Themes (with TWIG).
- Plugins (with symfony event dispatcher).
Some plugin highlights are:
- Ebooks: Generate one or many professional pdf books from your typemill website.
- Register: Let users register to your website and give them access to pro-content.
- Subscribe (in work): Sell subscriptions for premium content with traditional pdf-invoices.
- PHP 7.4 or PHP 8.0 (does NOT run with PHP 8.1)
- Apache server
- mod_rewrite and htaccess
If you run a linux system, then please double check that mod_rewrite and htaccess are active!!!
Download TYPEMILL from the TYPEMILL website, unzip the files and you are done.
If you are a developer, you can also clone this repository. To do so, open your command line, go to your project folder (e.g.
htdocs) and type:
git clone git://github.com/typemill/typemill.git
The GitHub-version has no vendor-folder, so you have to update and include all libraries and dependencies with composer. To do so, open your command line, go to your TYPEMILL folder and type:
If you did not use composer before, please go to the composer website and start to learn.
To run TYPEMILL on a live system, simply upload the files to your server
Make Folders Writable.
Make sure that the following folders and all their files are writable (permission
You can use your ftp-software for that.
⚠️This image does not provide TLS support. It's perfect either for local use or behind your own proxy, you're advised.
Clone and edit the
config.example.php you find in this repository and move it as
git clone git://github.com/trendschau/typemill.git cd typemill
Build your image locally
docker build -t typemill:local .
Run the docker image without persistence on port 8080
docker run -d --name typemill -p 8080:80 typemill:local
Run typemill with persistence
docker run -d \ --name=typemill \ -p 8080:80 \ -v $(pwd)/typemill_data/settings/:/var/www/html/settings/ \ -v $(pwd)/typemill_data/media/:/var/www/html/media/ \ -v $(pwd)/typemill_data/cache/:/var/www/html/cache/ \ -v $(pwd)/typemill_data/plugins/:/var/www/html/plugins/ \ -v $(pwd)/typemill_data/content/:/var/www/html/content/ \ -v $(pwd)/typemill_data/themes/:/var/www/html/themes/ \ typemill:local
docker-compose.yml file could looked like this
version: "2.0" services: typemill: image: typemill:local volumes: - /volume2/docker/typemill-test/settings/:/var/www/html/settings/ - /volume2/docker/typemill-test/media/:/var/www/html/media/ - /volume2/docker/typemill-test/cache/:/var/www/html/cache/ - /volume2/docker/typemill-test/plugins/:/var/www/html/plugins/ - /volume2/docker/typemill-test/content/:/var/www/html/content/ - /volume2/docker/typemill-test/themes/:/var/www/html/themes/ ports: - 8080:80
settings: persists users profiles, site configuration, etc. (empty by default)
media: persists media files (empty by default)
cache: persists cache files for performance purpose (optional and empty by default)
plugins: persists installed plugins (optional and empty by default)
content: persists content published (will be initialized with default examples if the binded volume is empty)
themes: persists installed themes (will be initialized with default examples if the binded volume is empty)
If you visit your website first, then you will be redirected to the
/setup page. Please create an initial user and configure your system in the author panel.
You can find your login screen under
/tm/login or simply go to
/setup and you will be redirected to the login-page, if the setup has been finished.
You can read the full documentation for writers, for theme developers and for plugin developers on the TYPEMILL website.
TYPEMILL is published under MIT licence. Please check the licence of the included libraries, too.
Contributors & Supporters
- Severo Iuliano manages the internationalization i18n.
- Eziquel Bruni edits the typemill documentation.
- Ricky developed the discard functionality.
- vodaris sponsored the development of the search plugin.
IMPORTANT: How to Contribute
Contributions are highly welcome. Please follow these rules:
- If you plan bigger changes, then please create an issue first so we can discuss it.
- Fork the
developbranch from typemill. Never use the master branch, because it is protected and only contains tested releases.
- Do your changes.
- After that pull the recent develop branch again to get the latest changes.
- Then make a pull request for the
You can check the roadmap for Typemill and scroll through the issues. I will mark issues in future that are easy to start with or where help is highly appreciated.
Here are some contribution-ideas for non-coder:
- Share Typemill with social media.
- Write about Typemill.
- Improve the documentation.
- Find bugs and errors (open a new issue on github for it).
- Describe some missing features and explain, why they are important for other users.
Some ideas for devs:
- Fix a bug.
- Create or port a theme, especially for documentations, knowlegde bases or web-books.
- Create a fancy plugin.
- An auto-update functionality for the core system, for plugins and for themes is highly welcome.
- Improve the accessibility of html and css.
- Write autotests with Cypress.
For hints, questions, problems and support, please open up a new issue on GitHub.
This is an open source project. I love it and I spend about 20 hours a week on it (starting in 2017). There is no business model right now, but you can support this project with a donation or simply hire me for implementations.