Search by

psyao / kami

psyao

Psyao Kami: a Laravel and Filament CMS for developers, at home on shared hosting.

Package info

github.com/psyao/kami

pkg:composer/psyao/kami

Statistics

Installs: 21

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 20


README

A Laravel and Filament CMS for developers, at home on shared hosting.

Psyao Kami, Kami for short, is a Composer package. Its admin is a plugin on your own Filament panel, and a site's content model is PHP code: Kami adds what a site needs without taking over the application. Everything runs on shared hosting with no cron, queue worker, Redis or Node on the server, and nothing essential depends on a remote service.

Kami is in early development: so far it covers installation, the environment check and the admin's wiring.

Requirements

  • PHP 8.5 or later, with the extensions listed in Installation
  • Laravel 13.32 or later and Filament 5.10.2 or later
  • SQLite, MySQL 8.4, MariaDB 10.11 or PostgreSQL 15 or later

Install

A new site starts from the starter kit:

laravel new site --using=psyao/kami-starter
cd site
php artisan kami:install
php artisan serve

kami:install asks for the first administrator, who signs in at /admin. To add Kami to an application you already have, see Existing application.

Documentation

  • Installation: requirements, creating a site, kami:doctor and kami:install
  • Existing application: adding Kami to a Laravel application and its panel
  • Content types: declaring a type and its Fields, writing and reading Entries
  • Multilingual: Locales, Translations, Shared Fields and Fallback with lang
  • Publishing: Draft, Scheduled and Published, validation, slugs, Content events, and why SaveEntry does not authorise
  • Users and roles: KamiUser, Roles in config/kami.php, Permissions and strict authorization
  • Routing and rendering: Kami::routes(), Paths and a type's render()
  • Security: the front and admin Content Security Policies, extending them, and the options that weaken them
  • Hosting: what Kami needs from shared hosting and from a server
  • Deployment: the first deploy and every later one, on Infomaniak shared hosting or a server
  • Decision records: why Kami is built the way it is

Contributing to Kami itself: Development.

Licence

MIT, see LICENSE.md.