⚡ TidyFactor HTMX v1.2.0

Server-Driven Hypermedia Interactivity & Contextual Decision Engine

The official hypermedia interaction track within the TidyFactor Architecture Ecosystem.

🚀 Quick Start • ⚡ 10 Commands • 🏛️ Ecosystem • 📖 بالعربية

---

This is a layer, not a full stack. It owns how fragments get requested, swapped, validated, and made navigable — not backend architecture or data. It pairs with tidyfactor-php or tidyfactor-php-micro (or any other server that can render HTML), rather than replacing them.

Three lifecycle modes

• Init — add the htmx layer to a project (new or existing backend).
• Convert — replace ad hoc fetch()/full-page-reload interactivity with htmx.
• Improve — audit and fix an existing htmx implementation.

Command set

init · assets · fragments · swap · triggers · forms · indicators · history · modules · i18n — see SKILL.md for full sequencing and each command's reference file under references/commands/.

Related skills

Part of the TidyFactor skill library — see tidyfactor-html (no backend), tidyfactor-php (vanilla backend), tidyfactor-php-micro (opinionated Flight+Medoo+Plates backend), and the planned tidyfactor-js / tidyfactor-js-micro tracks.

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 htmx

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

tidyfactor add htmx

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/htmx

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

Run the dedicated skill installer directly with automatic cache invalidation:

npx @tidyfactor/htmx@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: hello@tidyfactor.com
• 📱 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.