2020-11-15 16:43:38 +01:00
# <img src="admin/assets/images/icon.svg" height="28"> Formwork
2019-03-20 12:20:39 +01:00
2021-05-20 11:12:00 +02:00
[![Discord ](https://img.shields.io/discord/637658168754831380?color=%235865f2&label=chat&logo=discord&logoColor=%23fff )](https://discord.gg/5Q3BmNY)
2019-05-13 13:03:58 +02:00
[![GitHub Release Date ](https://img.shields.io/github/release-date/getformwork/formwork.svg )](https://github.com/getformwork/formwork/releases/latest)
[![GitHub All Releases ](https://img.shields.io/github/downloads/getformwork/formwork/total.svg )](https://github.com/getformwork/formwork/releases)
[![Packagist ](https://img.shields.io/packagist/dt/getformwork/formwork.svg?color=%23f28d1a&label=Packagist%20downloads )](https://packagist.org/packages/getformwork/formwork)
[![GitHub code size in bytes ](https://img.shields.io/github/languages/code-size/getformwork/formwork.svg )]()
[![PHP from Packagist ](https://img.shields.io/packagist/php-v/getformwork/formwork.svg )](#requirements )
2019-03-20 12:20:39 +01:00
2021-07-06 17:27:24 +02:00
🏗 Formwork is a flat file-based Content Management System (CMS) to build and manage simple sites.
2018-06-16 16:41:58 +02:00
2021-07-06 17:27:24 +02:00
⚠️ **This is the `README` file for the [`2.x`](https://github.com/getformwork/formwork/tree/2.x) branch, currently in development and NOT STABLE.**
👉 **See the [`1.x`](https://github.com/getformwork/formwork/tree/1.x) branch for the latest stable version.**
2018-07-10 17:26:32 +02:00
2018-06-16 16:41:58 +02:00
## Features
2019-04-27 14:23:29 +02:00
- ⚡️ Lightweight
- 🗄 No database required!
- 📦 Easy to [install ](#installing )
- ✨ Out-of-the-box Administration Panel
2018-06-16 16:41:58 +02:00
![](assets/images/formwork.png)
2018-07-10 17:26:32 +02:00
## Requirements
2021-07-06 17:27:24 +02:00
- PHP **7.4.0** or higher
2021-07-22 15:22:17 +02:00
- PHP extensions `fileinfo` , `gd` , `mbstring` , `openssl` and `zip`
2019-03-20 12:19:31 +01:00
## Installing
### From GitHub releases
2019-05-13 13:03:58 +02:00
You can download a ready-to-use `.zip` archive from [GitHub releases page ](https://github.com/getformwork/formwork/releases ) and just extract it in the webroot of your server.
2019-03-20 12:19:31 +01:00
### With Composer
If you prefer to install the latest stable release of Formwork with [Composer ](https://getcomposer.org/ ) you can use this command:
```
2019-05-13 13:03:58 +02:00
$ composer create-project getformwork/formwork
2019-03-20 12:19:31 +01:00
```
Composer will create a `formwork` folder with a fresh ready-to-use Formwork installation.
### Cloning from GitHub
If you want to get the currently worked master version, you can clone the GitHub repository and then install the dependencies with Composer.
1. Clone the repository in your webroot:
```
2019-05-13 13:03:58 +02:00
$ git clone https://github.com/getformwork/formwork.git
2019-03-20 12:19:31 +01:00
```
2. Navigate to `formwork` folder and install the dependencies:
```
$ cd formwork
$ composer install
```