Skip to content
@dotkernel

Dotkernel

A headless platform for building modern web applications — for humans and AI agents

Dotkernel is a set of open-source PHP applications - REST API, admin, and queue - that ship assembled on Mezzio and Laminas, over one shared Doctrine domain layer called Core. OAuth2, RBAC, HAL, and a generated OpenAPI spec are wired together on install, not left for you to choose.

Building Dotkernel applications with AI: dotboost

dotboost is drop-in Claude Code configuration for any Dotkernel application - API, Admin, Frontend, Light, Queue, or a project derived from one of them. The payload is a .claude/ directory you copy into your project root; every skill detects the variant first and applies the matching dialect, so the assistant follows this platform's conventions instead of generic PHP habits.

What it brings to a session:

  • /dk-* commands for the work that recurs - bootstrapping a fresh clone, planning a module, wiring a route end to end, tracing a request through the pipeline, running the QA gate, and a pre-PR convention review.
  • Skills covering the platform - module structure and Core layering, handler naming, Doctrine entities and migrations, input filters, HAL responses, OpenAPI attributes, the evolution pattern, testing, and the PSR standards as they are actually applied here.
  • A dependency ladder instead of guesswork - installed packages, then dotkernel/*, then Laminas and Mezzio, then vetted community packages, and only then hand-rolled code. Package names are verified against composer.lock or Packagist, never recalled from memory.
  • Guardrails that hold - *.local.php and data/oauth/ are unreadable, so database credentials and OAuth signing keys never reach the transcript. Dependency manifests, vendor/, and migrations cannot be written; installs, destructive git, and DB-mutating commands are blocked, including inside compound commands.

Being consumed by AI

A headless platform has no UI to explain itself, so the contract has to be machine-readable. That is the same property agents need, and we treat it as a first-class concern rather than an add-on:

  • A generated OpenAPI spec on every install - your endpoints, schemas, and auth flows are described in a format LLM-based tooling and agent frameworks read directly, with no hand-written docs to drift out of date.
  • Predictable, standards-based responses - HAL representations and PSR-7 messages mean an agent can traverse an API it has never seen before from the payload alone.
  • Agent-readable documentation - our content is published as markdown alongside the HTML, with an llms.txt index, so assistants and crawlers ingest the source text instead of scraping a rendered page.

Documentation

Documentation is available at: https://docs.dotkernel.org

Discussion

Open discussions are available at: https://github.com/orgs/dotkernel/discussions

Latest blog posts

Contributing and Support

Pinned Loading

  1. api api Public

    A production-ready REST API application built on the Mezzio microframework and Laminas components, which implements standards like PSR-3, PSR-4, PSR-7, PSR-11 and PSR-15.

    PHP 50 7

  2. admin admin Public

    A back office for complete control over the same data your API serves. A ready-to-go admin skeleton - table-based CRUD screens for your records, plus the pieces for reports and dashboards.

    PHP 39 8

  3. queue queue Public

    Queue management project, based on Mezzio, Symfony messenger and Swoole

    PHP 10 2

  4. light light Public

    The smallest complete Mezzio application — a PSR-15 pipeline, routing and templating, with nothing to strip out. A real starting point for a simple site.

    PHP 11 5

  5. development development Public

    AlmaLinux on WSL2 for a RHEL-compatible local stack. One install script configures PHP, Apache, MariaDB, Git, Composer, Node.js, and phpMyAdmin.

    Jinja 8 4

  6. frontend frontend Public

    Dotkernel Frontend Application. Based on Mezzio microframework using Laminas components.

    PHP 25 6

Repositories

Showing 10 of 89 repositories

Top languages

Loading…

Most used topics

Loading…