🐱 KHAT Stack

Features

• ⚡️ Uses Vite tooling with kirby-vite plugin.
• 🔄 Live Reloading for Kirby templates, snippets, content, ... changes.
• 📂 Kirby Cms Public folder structure
• 🥰 Htmx, AlpineJs & TailwindCSS for Html driven development.
• 🌎 Fully managed site template including kirby flat file db engine.
• 🍀 Git Based CI including git based production backups.
• 🐋 easy & instant Git based deployment on a dokku PaaS.

Getting Started

Prerequisites

Before you begin, ensure you have the following prerequisites:

• Node.js (>=14.x)

• Composer

• PHP (for Kirby CMS)

• Dokku (on production server)

Installation

1. Clone this repository:

git clone https://github.com/your-username/your-repo.git
cd your-repo
npm install
cp .env.example .env

Development

To start a local development server:

npm run dev

This command will start both the PHP server for Kirby CMS and the Vite development server.

Access the Kirby CMS admin panel at /panel and the development site at http://localhost:8888.

Deployment

To deploy your application using Dokku, follow these general steps:

1. Set up a Dokku instance and configure it.
2. Add your Dokku server as a remote:

git remote add <remote-app-prod> dokku@your-server:<remote-app>

Deploy your application:

git push <remote-app-prod> prod

For more details on deploying with Dokku, refer to the Dokku documentation.

Contributing

Feel free to open issues or pull requests for improvements, bug fixes, or new features. We welcome your contributions!