- ⚡️ Uses Vite with kirby-vite plugin
- 📚 Multiple pages
- 🔄 Live Reloading for Kirby templates, snippets, content, ... changes
- 📂 Public folder structure
Clone this repository and run:
composer install
npm install
Start vite's dev server and a simple php dev server by running:
npm run dev
Visit localhost:8888
in the browser. Vite's dev server (localhost:5173
) is only used for serving js, css and assets.
Get a local production preview by running:
npm run preview
Build your optimized frontend assets to public/dist
:
npm run build
If your are using VS Code, you can add file nesting to visually organize your assets in the editor's file explorer:
// .vscode/settings.json
{
"explorer.fileNesting.enabled": true,
"explorer.fileNesting.patterns": {
"*.js": "${capture}.css"
},
}
Upload the repository to your web server and point your web server to the repository's public
folder.
If you have ssh access you can use rsync to automate the upload/sync.
You can also deploy your repository with git. Then you have to run the installation steps again on your web server.
Because this is a started kit and not a library it doesn't use semantic versioning. If you wan't to migrate an existing project please look for any breaking changes in the release note.