GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com โ€” GitHub - TidyFactor/PHP: The Modern PHP Architecture track of the TidyFactor skill library

BranchesTags
Open more actions menu

Latest commit

 

History

17 Commits
17 Commits

Folders and files

NameName
Last commit message
Last commit date
.agents/skills/tidyfactor-php
.agents/skills/tidyfactor-php
 
 
.claude-skill
.claude-skill
 
 
.github
.github
 
 
assets
assets
 
 
bin
bin
 
 
memory
memory
 
 
references
references
 
 
templates
templates
 
 
tools
tools
 
 
.gitignore
.gitignore
 
 
.tidyfactor
.tidyfactor
 
 
AGENTS.md
AGENTS.md
 
 
CHANGELOG.md
CHANGELOG.md
 
 
LICENSE
LICENSE
 
 
README.ar.md
README.ar.md
 
 
README.de.md
README.de.md
 
 
README.es.md
README.es.md
 
 
README.fa.md
README.fa.md
 
 
README.fr.md
README.fr.md
 
 
README.md
README.md
 
 
README.pt.md
README.pt.md
 
 
README.zh.md
README.zh.md
 
 
SKILL-REGISTRY.md
SKILL-REGISTRY.md
 
 
SKILL.md
SKILL.md
 
 
VISION.md
VISION.md
 
 
brand.json
brand.json
 
 
package.json
package.json
 
 
publish_npm.py
publish_npm.py
 
 

Repository files navigation

๐Ÿ˜ TidyFactor PHP v1.2.0

Modern Modular Monolith, Component UI & Locked 13-Module Platform Engine

The official modern PHP 8.x architecture track within the TidyFactor Ecosystem.

npm version License: Apache 2.0 RTL Ready PHP 8.4+

๐Ÿš€ Quick Start โ€ข โšก 15 Commands โ€ข ๐Ÿ›๏ธ Ecosystem โ€ข ๐Ÿ“– ุจุงู„ุนุฑุจูŠุฉ



TidyFactor PHP Hero Banner


Part of the TidyFactor ecosystem. The larger sibling of tidyfactor-php-micro โ€” same locked-stack philosophy, scaled from "small starter with an admin panel" up to "extensible platform" โ€” and this is the largest, most opinionated PHP track in the family.

Not a Laravel clone. Not headless. Not API-first.

The browser talks directly to PHP: Browser โ†’ Flight Router โ†’ Controller โ†’ Service โ†’ Repository โ†’ Medoo โ†’ MySQL โ†’ Plates View โ†’ HTML Response. No REST API, no GraphQL, no SPA, no React/Vue/Inertia/Livewire.

What's locked vs. what's extensible

  • Locked stack: PHP 8.4+, Flight, Medoo, Plates, Tailwind CSS (precompiled static file, zero server-side build step), Alpine.js, MySQL/MariaDB, session-based auth โ€” every frontend library vendored and pinned, never CDN-loaded.
  • Locked admin shape: exactly 13 modules โ€” Dashboard, Pages, Posts, Media Library, Menus, Users, Roles, Permissions, Settings, Themes, Plugins, Logs, Profile. Extending past 13 is always a confirmed decision, never a silent default.
  • A real, always-asked fork: HTMX progressive enhancement, on or off.
  • Architecture-ready, not pre-built: multi-language content, multi-site, multi-tenant, AI integrations, search indexing, background jobs, webhooks, an optional REST API, CLI commands, a scheduler, object storage, and CDN integration are future extension points via the event/plugin system โ€” not implemented now.

Three lifecycle modes

  • Init โ€” scaffold the full monolith: bootstrap, DI container, event dispatcher, plugin loader, theme loader, auth, an example CRUD (Pages), and the default theme, working end to end.
  • Convert โ€” bring an existing PHP site/CMS onto this architecture.
  • Improve โ€” audit and harden a project already on this stack.

Command set

init ยท secure ยท assets ยท logic ยท store ยท compo ยท route ยท pages ยท themes ยท plugins ยท events ยท admin ยท rbac ยท media ยท cache ยท i18n ยท logging ยท seo ยท deploy โ€” see SKILL.md for the full sequencing and each command's reference file under references/commands/.

Related skills

Part of the TidyFactor skill library โ€” see tidyfactor-php-micro (a much smaller, fixed-scope starter), tidyfactor-php (vanilla, bring-your-own architecture), tidyfactor-html (no backend), and tidyfactor-htmx (the full hypermedia-interaction layer, layered on top once htmx is actually adopted beyond this skill's optional fork).

Developer

Built and maintained by alwkala โ€” github.com/alwkala

License

Licensed under the Apache License 2.0.


๐Ÿš€ Installation & Quick Start

Choose your preferred installation method:

Option A: Via TidyFactor CLI (Recommended)

Install directly using the official ecosystem package runner into your active workspace:

npx @tidyfactor/cli add php

Or if you have the CLI installed globally (npm i -g @tidyfactor/cli):

tidyfactor add php

Option B: Via Open Agent Skills Ecosystem (skills.sh / Vercel Labs)

Install using the universal multi-agent standard across all supported IDEs (Cursor, Antigravity, Claude Code, Windsurf, Trae, Codex):

npx skills add tidyfactor/php

Option C: Standalone Zero-Dependency Runner (NPM Direct)

Run the dedicated skill installer directly with automatic cache invalidation:

npx @tidyfactor/php@latest

๐Ÿ›๏ธ TidyFactor Ecosystem Architecture

TidyFactor is a modular web architecture and AI coding agent skill ecosystem built on clear separation of concerns across the product lifecycle:

TidyFactor Organization (github.com/TidyFactor)
โ”‚
โ”œโ”€โ”€ Design Skills
โ”‚   โ”œโ”€โ”€ Cinematic    โ†’ Experience / "Wow"     (Apple ร— Cartier Scroll-Driven Landing Pages)
โ”‚   โ”œโ”€โ”€ Design       โ†’ Prototype / "Build"    (Code-Native UI Design Engine & Figma Alternative)
โ”‚   โ””โ”€โ”€ Styler       โ†’ Production / "Ship"    (Framework Styler & RTL Polish Engine)
โ”‚
โ”œโ”€โ”€ Development Skills
โ”‚   โ”œโ”€โ”€ HTML         โ†’ Content & Static       (Semantic SEO & Static Platform Starter)
โ”‚   โ”œโ”€โ”€ HTMX         โ†’ Hypermedia             (Server-Driven Micro-Interactions)
โ”‚   โ”œโ”€โ”€ JS           โ†’ Vanilla SPA            (Framework-Free Reactive ES Modules)
โ”‚   โ”œโ”€โ”€ PHP          โ†’ Server-Rendered        (Modern PHP 8.x Component UI & Architecture)
โ”‚   โ””โ”€โ”€ Next         โ†’ Multi-Tenant SaaS      (Next.js 16, React 19, Supabase RLS & Dev-Perf)
โ”‚
โ””โ”€โ”€ Growth Skills
    โ””โ”€โ”€ Marketing    โ†’ Growth / Revenue       (Direct Response, Pillar SEO & Content Lifecycles)

๐Ÿ’Ž Frontend Triad

                TidyFactor
                    โ”‚
          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
          โ”‚         โ”‚         โ”‚
      Cinematic   Design    Styler
          โ”‚         โ”‚         โ”‚
      Experience Prototype Production
          โ”‚         โ”‚         โ”‚
       "Wow"      "Build"   "Ship"

๐Ÿ“ฆ Community Package & Skill Parity

Track Category GitHub Repository Agent Skill NPM Package
Cinematic Design TidyFactor/Cinematic tidyfactor-cinematic @tidyfactor/cinematic
Design Design TidyFactor/Design tidyfactor-design @tidyfactor/design
Styler Design TidyFactor/Styler tidyfactor-styler @tidyfactor/styler
Next Development TidyFactor/Next tidyfactor-next @tidyfactor/next
HTML Development TidyFactor/HTML tidyfactor-html @tidyfactor/html
HTMX Development TidyFactor/HTMX tidyfactor-htmx @tidyfactor/htmx
JS Development TidyFactor/JS tidyfactor-js @tidyfactor/js
PHP Development TidyFactor/PHP tidyfactor-php @tidyfactor/php
Marketing Growth TidyFactor/Marketing tidyfactor-marketing @tidyfactor/marketing

๐Ÿ‘จโ€๐Ÿ’ป Organization & Support

  • ๐ŸŒ Official Website: https://tidyfactor.com/
  • ๐Ÿ“š Official Documentation: https://tidyfactor.com/documentation
  • ๐Ÿค Official Partner Website: Alwkala Digital Agency
  • ๐Ÿ™ GitHub Organization: github.com/TidyFactor
  • ๐Ÿ“ง Business Inquiries: [email protected]
  • ๐Ÿ“ฑ WhatsApp: +20 101 665 6899
  • ๐Ÿ“ž Phone: +20 101 665 6899
  • ๐Ÿ“ Location: Cairo, Egypt

๐Ÿ“œ License

Licensed under the Apache License 2.0. Copyright (c) 2026 TidyFactor & Alwkala.

About

The Modern PHP Architecture track of the TidyFactor skill library

tidyfactor.com

Topics

flightphpmedoomodular-architecturemonolith-architecturemysqlphpplates-templatesserver-side-renderingskillstailwindcsstidyfactor

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Contributors

Languages

You are visitor 01402503 โ€” GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800ร—600. No cookies required.