Skip to content

README.md

Latest commit

 

History

History
146 lines (112 loc) · 6.72 KB

README.md

File metadata and controls

146 lines (112 loc) · 6.72 KB
Raw

🌐 TidyFactor HTML v1.2.0

100% Static Platform Starter, Web Components & Contextual Decision Engine

The official static web engineering track within the TidyFactor Architecture Ecosystem.

npm version License: Apache 2.0 RTL Ready Zero Runtime

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



TidyFactor HTML Hero Banner

Part of the TidyFactor ecosystem. Sibling tracks (tidyfactor-php, tidyfactor-vanilla-js, tidyfactor-micro-js, tidyfactor-track-*) live as separate skills so each can carry a full, framework-appropriate command set instead of one skill trying to cover every stack at once.

Three lifecycle modes

  • Init — scaffold a brand-new static project.
  • Convert — bring an existing site, SPA, or other stack onto this track.
  • Improve — audit and upgrade a project already on this track.

Command set

init · assets · compo · store · pages · modules · i18n · seo · deploy — see SKILL.md for the full sequencing and each command's reference file under references/commands/.

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 html

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

tidyfactor add html

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

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

Run the dedicated skill installer directly with automatic cache invalidation:

npx @tidyfactor/html@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

📜 License

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