This project is a very basic but opinionated Kirby (v4) Starterkit using some established Kirby CMS Plugins. The folder structure is following the "Public folder setup" instructions from the Kirby Guide.
Frontend is based on Vite, tailwindcss and Alpine.js.
It comes with is a development setup based on Docker including Xdebug and Mailpit as services, but you can choose to use your local environment instead.
$ git clone [email protected]:fork/kirby-starterkit.git .
$ docker compose up -d
$ docker compose exec -it php composer installAfter installing the essential requirements for Kirby these instructions should be enough to get the project up and running on your local maschine.
$ git clone [email protected]:fork/kirby-starterkit.git .
$ composer install
$ php -S localhost:8000 -t public kirby/router.phpThe frontend build gets ignored by Git so you will have to run it initially. It is build directly to the Kirby public folder by the following command.
$ yarn install
$ yarn buildVisit the admin panel at http://localhost:8000/panel and finalize the installation.
You could also just start developing Frontend components by starting Vite.
$ yarn devTo configure the Timezone of the PHP service you can change the build args of the compose file before installation. e.g.:
TIME_ZONE: "Europe/Berlin"There is a handy Mailpit service running and configured in the localhost configuration. When starting the Docker setup, you can access Mailhog by navigating to http://localhost:8025/.
The PHP Service is configured with Xdebug. You can change the needed XDEBUG_MODE via environment variable when starting the setup.
$ XDEBUG_MODE=debug docker compose up -dIf you are working with Visual Studio Code you could use the following launch.json configuration.
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html/": "${workspaceFolder}"
}
}
]
}
For more information on Docker basics related to Kirby you can find a very good guide in the Kirby Cookbook.
This "Kirby Docker Starterkit" is licensed under the MIT License. Please see License File for more information. Kirby itself is commercial software and has its own commercial license.
Brought to you by Fork Unstable Media GmbH