PHPackages                             mmollay/gridkit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. mmollay/gridkit

ActiveLibrary[Framework](/categories/framework)

mmollay/gridkit
===============

Agent-ready PHP component framework for admin dashboards. Zero dependencies, Material Design 3, AJAX-first.

v1.4.0(2mo ago)21MITPHPPHP &gt;=8.2

Since Mar 26Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/mmollay/gridkit)[ Packagist](https://packagist.org/packages/mmollay/gridkit)[ Docs](https://gridkit.ssi.at)[ RSS](/packages/mmollay-gridkit/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (6)DependenciesVersions (2)Used By (0)

GRIDKit
=======

[](#gridkit)

**Agent-ready PHP component framework for admin dashboards.** Zero dependencies, Material Design 3, AJAX-first.

[![Version](https://camo.githubusercontent.com/e99600a5d6bc72fb7f0f432fcefea761215fcac2865c0f23afd29ae986049948/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e322e332d626c7565)](https://github.com/mmollay/gridkit/releases/tag/v1.2.3)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](LICENSE)[![PHP](https://camo.githubusercontent.com/3f55c87364aa35ec65a7ab89134395aeaa6e28f40f60be1006eaff8c088b40e9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322b2d707572706c65)](https://php.net)

Why GRIDKit?
------------

[](#why-gridkit)

- **17+ components, 1 CSS file, 1 JS file.** Zero dependencies.
- **Agent-first design** — feed the [Agent Skill](GRIDKIT_SKILL.md) to your AI and it generates complete CRUD apps.
- **6 themes** with light &amp; dark mode via CSS Custom Properties (M3-inspired).
- **AJAX-first** — tables search, sort, filter, paginate without page reloads.
- **No jQuery, no Bootstrap, no npm, no build process.** Clone and go.

Quick Start
-----------

[](#quick-start)

```
git clone https://github.com/mmollay/gridkit.git
```

```
require_once '/path/to/gridkit/autoload.php';
```

Use the skeleton as a starting point:

```
cp gridkit/skeleton.php my-app/index.php
```

`skeleton.php` includes: Sidebar, Header (fixed), Theme Switcher, Content Area, Modal Container, JS — all wired up.

Agent Skill — Let AI Build For You
----------------------------------

[](#agent-skill--let-ai-build-for-you)

The [`GRIDKIT_SKILL.md`](GRIDKIT_SKILL.md) file teaches any AI assistant (Claude, GPT, Gemini) how to use GRIDKit. Add it to your agent's project context:

1. Download `GRIDKIT_SKILL.md` from the repository
2. Add it to your AI agent's context or project knowledge
3. Describe what you need: *"Create a user management dashboard"*
4. The agent generates working GRIDKit PHP code — tables, forms, modals, all wired up

Example — CRUD Table in 12 Lines
--------------------------------

[](#example--crud-table-in-12-lines)

```
use GridKit\Table;

$table = new Table('products');
$table->query($db, "SELECT * FROM products ORDER BY name")
    ->search(['name', 'sku'])
    ->column('name', 'Product', ['sortable' => true])
    ->column('sku', 'SKU', ['width' => '120px'])
    ->column('price', 'Price', ['format' => 'currency', 'sortable' => true])
    ->column('is_active', 'Status', ['format' => 'label'])
    ->button('edit', ['icon' => 'edit', 'modal' => 'edit_product'])
    ->modal('edit_product', 'Edit', 'forms/product.php', ['size' => 'medium'])
    ->newButton('New Product', ['modal' => 'edit_product'])
    ->paginate(25)
    ->render();
```

Components (17+)
----------------

[](#components-17)

ComponentDescription**Table**6 variants, search, sort, pagination, multi-select, mobile card layout**Form**16-column grid, 15 field types, AJAX submit, validation**Modal**Stackable dialogs, form-ready, 3 sizes**Sidebar**Groups, badges, collapse, mobile overlay**Header**Fixed, search, user dropdown, theme switcher**StatCards**KPI display with trends and colors**Cards**Responsive grid (auto-fill, 2/3/4 columns)**Segment**Container variants (raised, muted, compact, padded)**Message**Info/Success/Warning/Error with dismiss**Accordion**Collapsible sections, single-open mode**Tabs**Tab navigation with panels**Breadcrumb**Path navigation with icons**Avatar**5 sizes, status dots, groups**Gallery**Thumbnail grid, lazy loading, masonry**Lightbox**Fullscreen preview, keyboard navigation**Buttons**Filled/Outlined/Text/Tonal, FAB, 5 colors**Auth**Session auth, bcrypt, remember-me, styled loginFormatters
----------

[](#formatters)

FormatOutputExample`currency``1,234.56 €``['format' => 'currency']``percent``20%``['format' => 'percent']``date``13.02.2026``['format' => 'date']``datetime``13.02.2026 08:30``['format' => 'datetime']``boolean`✓ / ✗`['format' => 'boolean']``label`Color-coded label`['format' => 'label']``email`Clickable link`['format' => 'email']`Theming
-------

[](#theming)

6 built-in themes: **Indigo**, **Ocean**, **Forest**, **Rose**, **Amber**, **Slate** — each with light &amp; dark mode.

```
/* Custom theme — just override variables */
.gk-root {
    --gk-primary: #8b5cf6;
    --gk-bg: #1a1a2e;
}
```

Structure
---------

[](#structure)

```
gridkit/
├── autoload.php           # PSR-4 Autoloader
├── skeleton.php           # Starting point for new projects
├── GRIDKIT_SKILL.md       # Agent Skill for AI assistants
├── src/                   # PHP components
├── css/
│   ├── gridkit.css        # Core styles
│   └── themes.css         # All themes + dark mode
├── js/
│   └── gridkit.js         # Vanilla JS (event delegation)
└── demo/
    └── index.php          # Live demo of all components

```

Requirements
------------

[](#requirements)

- PHP 8.2+
- MySQLi (for DB queries)
- Modern browser (CSS Custom Properties, Fetch API)

Links
-----

[](#links)

- **Live Demo:** [gridkit.ssi.at/demo](https://gridkit.ssi.at/demo/)
- **Landing Page:** [gridkit.ssi.at](https://gridkit.ssi.at)
- **Agent Skill:** [GRIDKIT\_SKILL.md](GRIDKIT_SKILL.md)

License
-------

[](#license)

MIT — [Martin Mollay](https://github.com/mmollay)

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance88

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

89d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/21ffc7e406d36b9fa9ac3a3c7f176093b75a3904cb9e70d7768d553b5aebfaf0?d=identicon)[ssi-web](/maintainers/ssi-web)

---

Top Contributors

[![mmollay](https://avatars.githubusercontent.com/u/10619091?v=4)](https://github.com/mmollay "mmollay (151 commits)")[![ssi-web](https://avatars.githubusercontent.com/u/267329365?v=4)](https://github.com/ssi-web "ssi-web (63 commits)")

---

Tags

admin-dashboardai-agentcomponentscrudframeworkmaterial-designphpphp-frameworkvanilla-jszero-dependencyphpframeworkcomponentscruddashboardadminmaterial-designai-agentzero-dependency

### Embed Badge

![Health badge](/badges/mmollay-gridkit/health.svg)

```
[![Health](https://phpackages.com/badges/mmollay-gridkit/health.svg)](https://phpackages.com/packages/mmollay-gridkit)
```

###  Alternatives

[florientr/laravel-gentelella

The Laravel 5.4 framework with Gentelella template

2325.5k](/packages/florientr-laravel-gentelella)[kompo/kompo

Laravel &amp; Vue.js FullStack Components for Rapid Application Development

11914.4k42](/packages/kompo-kompo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
