Modern, Crazy Fast, Ridiculously Easy and Amazingly Powerful Flat-File CMS
Grav is a Fast, Simple, and Flexible, file-based Web-platform. There is Zero installation required. Just extract the ZIP archive, and you are already up and running. It follows similar principles to other flat-file CMS platforms, but has a different design philosophy than most. Grav comes with a powerful Package Management System to allow for simple installation and upgrading of plugins and themes, as well as simple updating of Grav itself.
The underlying architecture of Grav is designed to use well-established and best-in-class technologies to ensure that Grav is simple to use and easy to extend. Some of these key technologies include:
The full documentation can be found from learn.getgrav.org.
These are the options to get Grav:
You can download a ready-built package from the Downloads page on https://getgrav.org
You can create a new project with the latest stable Grav release with the following command:
$ composer create-project getgrav/grav ~/webroot/grav
Clone the Grav repository from https://github.com/getgrav/grav to a folder in the webroot of your server, e.g.
~/webroot/grav. Launch a terminal or console and navigate to the webroot folder:
$ cd ~/webroot $ git clone https://github.com/getgrav/grav.git
Install the plugin and theme dependencies by using the Grav CLI application
$ cd ~/webroot/grav $ bin/grav install
Check out the install procedures for more information.
$ bin/gpm index
This will display all the available plugins and then you can install one or more with:
$ bin/gpm install
To update Grav you should use the Grav Package Manager or
$ bin/gpm selfupgrade
To update plugins and themes:
$ bin/gpm update
We appreciate any contribution to Grav, whether it is related to bugs, grammar, or simply a suggestion or improvement! Please refer to the Contributing guide for more guidance on this topic.
If you discover a possible security issue related to Grav or one of its plugins, please email the core team at [email protected] and we'll address it as soon as possible.
Support Grav with a monthly donation to help us continue development. [Become a backer]
Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]
First install the dev dependencies by running
composer installfrom the Grav root.
composer testwill run the Unit Tests, which should be always executed successfully on any site. Windows users should use the
composer test-windowscommand. You can also run a single unit test file, e.g.
composer test tests/unit/Grav/Common/AssetsTest.php
To run phpstan tests, you should run:
composer phpstanfor global tests
composer phpstan-frameworkfor more strict tests
composer phpstan-pluginsto test all installed plugins