Skip to content
@dotkernel

Dotkernel

Dotkernel

A headless platform to build modern web applications, for humans and AI agents

Dotkernel is a set of open-source PHP applications: a REST API, an admin application and a queue. They are built on Mezzio and Laminas, and they share one Doctrine domain layer, called Core. The installation connects OAuth2, RBAC, HAL and a generated OpenAPI specification, so you do not have to select and connect them yourself.

Build Dotkernel applications with AI: dotboost

dotboost is a drop-in configuration that teaches Claude Code the conventions of any Dotkernel application. It supports API, Admin, Frontend, Light, Queue, and each project derived from one of them. Its payload is the .claude/ directory, which you copy into the root of your project. Each skill first detects the variant, then applies the matching dialect. Thus, the assistant follows the conventions of this platform, and not general PHP habits.

dotboost gives a session these items:

  • /dk-* commands for frequent work. They bootstrap a new clone, plan a module, add a fully wired route, trace a request through the pipeline, run the QA gate, and review the changes before a PR.
  • Skills for the platform. They cover the module structure and the Core layer, handler naming, Doctrine entities and migrations, input filters, HAL responses, OpenAPI attributes, the evolution pattern, testing, and the PSR standards as Dotkernel applies them.
  • A dependency ladder, not guesses. Claude selects a package in this order: installed packages, dotkernel/*, Laminas and Mezzio, vetted community packages, and hand-rolled code last. Claude never names a package from memory. It verifies a name against composer.lock or against the dotkernel/* listing that dotkernel.com publishes, and calls all other names unverified.
  • One writing style: ASD-STE100 Simplified Technical English. Chat answers, commit messages, PR descriptions, docs, code comments, exception messages, CLI output and OpenAPI descriptions use short sentences, the active voice and one meaning for each word. The review checks the new prose against these rules.
  • Guardrails. Claude cannot read *.local.php, .env or data/oauth/, so in normal work the database credentials and OAuth signing keys stay out of the transcript. Claude cannot write the dependency manifests, vendor/ or the migrations. Hooks block installs, destructive git commands and commands that change the database, also inside compound commands.

For AI agents

A headless platform has no UI that explains it, so its contract must be machine-readable. AI agents need the same property. We give it high priority, and do not treat it as an add-on:

  • A generated OpenAPI specification on each install. It describes your endpoints, schemas and authentication flows. LLM tools and agent frameworks read this format directly, and no hand-written docs become out of date.
  • Predictable responses that obey standards. With HAL representations and PSR-7 messages, an agent can navigate an API that it does not know from the payload alone.
  • Documentation that agents can read. We publish our content as Markdown next to the HTML, with an llms.txt index. Thus, assistants and crawlers read the source text, and do not scrape a rendered page.

Documentation

The documentation is at https://docs.dotkernel.org.

Discussion

The open discussions are 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 51 8

  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 9

  3. queue queue Public

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

    PHP 11 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 11 5

  6. frontend frontend Public

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

    PHP 25 7

Repositories

Showing 10 of 89 repositories

Top languages

Loading…

Most used topics

Loading…