Skip to content

v0.1.0-alpha — first public alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Shepdesign Shepdesign released this 21 May 21:27
· 57 commits to main since this release
v0.1.0-alpha
819e608

hooked on facets v0.1.0-alpha — first public alpha

The first installable cut of hooked on facets. Twelve facet displays, a React 18 admin SPA, a vanilla JS public runtime, and a conversational Ask facet that turns plain English into editable filter chips.

⚠️ Pre-alpha. The indexer is demo-grade. WooCommerce integration is wired but not bulletproofed. Don't ship this to a production storefront yet — but it's installable and the surface is there to play with.

What's in the box

Ten public facet displays:

Display What it is
Checkbox Multi-select list with live counts
Radio Single-select, plus an "Any" reset
Dropdown Native <select> with counts inline
Toggle Boolean switch with configurable true value
Hierarchy Nested taxonomy tree with collapsible <details>
Range Slider Two-number range, live drill-down bounds
Date Range HTML5 <input type="date"> min/max
Search LIKE-match within the result set
Color Swatch Fluid-size tiles sized by bucket weight
Swipe Deck Touch-first card stack — swipe right to include

Two view facets (no source of their own — they orchestrate other facets):

  • 2D Slider — drag a rectangle on an XY plane to range-filter on two numeric facets at once.
  • Ask — conversational, multi-turn. Type "comfy red shoes under $50," see the model's interpretation as removable chips, type "…also under $40" to refine. BYOK — bring your own Anthropic API key, stored server-side, never sent to the browser.

Architecture

  • PHP 8.2+, PSR-4, Composer. WordPress 6.4+.
  • React 18 admin SPA on @wordpress/components — native WP feel.
  • Vanilla JS public runtime — no framework on the storefront, ~21 kB pre-gzip.
  • Vite 8 build, Node 22+.
  • Custom indexed table for fast facet lookups (drill-down counts, range bounds, LIKE search).
  • REST endpoints under /wp-json/hof/v1/.

Install

  1. Download hooked-on-facets-0.1.0-alpha.zip from this release.
  2. WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
  3. Navigate to HOF in the admin sidebar to start configuring facets.
  4. (Optional) For the Ask facet, set your Anthropic API key under HOF → Ask. Each turn is ~$0.0001–$0.0005 on Haiku 4.5.

Known gaps in this alpha

  • Indexer is demo-grade. Term/meta indexing is correct for the included demo dataset but isn't yet bulletproofed for arbitrary stores. Re-indexing is admin-button-only — no incremental indexing on post save yet.
  • Date Range depends on the source meta being stored as Unix timestamps in facet_numeric. The Indexer's automatic date→epoch conversion is a v0.2 follow-up.
  • Admin is missing create/edit/delete CRUD for facets; configurations land via REST or wp_options directly.
  • Dropdown is single-select only; multi-select is a v0.2 follow-up.
  • WooCommerce integration (categories, attributes, price) works on the demo but isn't yet treated as a first-class integration layer.

What's next (v0.1 → v0.2)

  • Real Indexer foundation (incremental indexing, date support, attribute indexing)
  • First-class WooCommerce integration
  • Admin create/edit/delete flow with reorderable list
  • Documentation pass: install, quick start, first facet
  • Gutenberg block + shortcode parity

See the Roadmap for the longer view.

Documentation

The GitHub Wiki has a page per facet type plus Architecture, Brand Voice, and Core Concepts.

Feedback

This is intentionally rough. Issues, PRs, and "this didn't work for me" reports all welcome — open an issue on the repo.

Assets 3
Loading