Search by

leungd / tatami

leungd

There is no license information available for the latest version (dev-main) of this package.

Base theme for ULM

Package info

github.com/leungd/tatami

Type:wordpress-theme

pkg:composer/leungd/tatami

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 4

dev-main 2026-10-19 19:32 UTC

Requires

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

Unknown License e7ae724f2ac532db5b0008771138c36cb6ae7294

  • leungd <derek.woop@umbrellalegalmarketing.com>

Published on Packagist.org on 2026-10-19 19:32 UTC

This package is auto-updated.

Last update: 2026-10-22 06:10:17 UTC

README

A WordPress base theme for professional-services sites, built on Timber/Twig, Tailwind CSS 4 and Vite. Each site is a derivative: a copy of this theme that pulls updates from here and keeps everything site-specific to itself.

Requirements

  • PHP 8.0+
  • WordPress 6.x
  • Composer
  • Node.js and pnpm (see .nvmrc)
  • ACF Pro (optional at runtime; the theme renders without it)
  • Yoast SEO (required at launch by house policy; owns SEO output and the schema graph)

Installation

  1. Copy the theme into wp-content/themes/
  2. composer install
  3. pnpm install

Commands

pnpm dev        # Vite dev server with HMR
pnpm build      # Production build → build/ (never committed; built before each push)
pnpm preview    # Preview the production build
pnpm lint       # ESLint + the Twig hero guardrail
pnpm test       # Node tests (linter, recipes) + PHP tests of the pure helpers
pnpm format     # Prettier for JS, CSS and Twig

Where things are

Path What it is
AGENTS.md The rules: stack, conventions, house-tool invariants, definition of done. Read this first.
docs/ One reference doc per house tool and convention (hero, schema, attribution, FAQs, related posts, ACF fields, launch checklist)
recipes/acf/ ACF field-group JSON for the house tools, with a SITE placeholder to copy into a site's acf-json/
CONTEXT.md Glossary of the terms the theme and its docs use (Firm, Professional, Service, Host, …)
lib/ PHP classes in the Tatami\ namespace: site setup, queries, assets, Vite bridge, schema, attribution, social profiles
views/ Twig templates: base.twig, page and single templates, partials/, macros/, modules/
src/css/tailwind.css Tailwind configuration (CSS-first), design tokens, the fluid grid and type scale
src/js/main.js JavaScript entry point; imports the CSS
tests/ PHP test runner for the pure helpers
scripts/ The Twig linter and the node tests

Building a site on Tatami

Clone the theme, point its remote at this repo as a pull-only upstream, then follow "Extending for a new site" in AGENTS.md. Before launch, work through docs/launch.md.

Base changes are made here by the maintainer. A derivative reports a base bug or fix as a GitHub issue on this repo; it never pushes or opens a pull request.

License

See LICENSE.