# Wabbit

> Reference for the Tome package library: the block packs, themes, and platform packages we build Wabbit sites on — generated from the source we ship.

## Foundation

- [Core](https://wabbit.com/docs/packages/core): Foundation package for the Tome platform — auth, access control, field factories, data utilities, and infrastructure presets for Payload CMS + Next.js sites; every other @wabbit/tome-* layer builds on this one.
- [Local (Preview)](https://wabbit.com/docs/packages/local): Tome local-business layer — the site's own business profile (a Payload global with hours, split shifts, dated overrides, named schedules, service areas, credentials and an expiring availability status), a cached public projection, a live-status source registry, a browser-safe open-state utility and a LocalBusiness JSON-LD builder.
- [Portfolio (Preview)](https://wabbit.com/docs/packages/portfolio): Tome portfolio layer — a site's body of work as records: numbered projects typed by the site's own taxonomy, a story of passages and plates with an image mode per item, structured credits, a vocabulary global, a server read API (filtered list with conditional facet counts, featured, next, computed facts) and an isomorphic filters entry for URL filter state.
- [Maps (Preview)](https://wabbit.com/docs/packages/maps): Tome maps layer — a neutral map seam: the provider and geocoder contract, a registry, MapLibre, Google and Mapbox providers (SDKs stay optional peers), deferred loading until a visitor asks for the map, a fallback for a failed or blocked map, and the pin, cluster and framing helpers a legend needs.
- [Practice (Preview)](https://wabbit.com/docs/packages/practice): Tome practice layer — who works at a business, what it offers and what people come looking for, as linked records: people, offerings, topics and groups with a vocabulary global, a server read API that filters both sides of every link and computes review state, availability and credential expiry at read time, and an isomorphic filters entry.
- [Ui](https://wabbit.com/docs/packages/ui): Token-driven design primitive library — the ui layer of the Tome stack (3-layer token system: source, semantic, variant selectors); zero @wabbit/* dependencies, composed by every layer above it.
- [Motion](https://wabbit.com/docs/packages/motion): Client-side motion adapter layer — React bindings over GSAP, @gsap/react, and Lenis, plus a prefers-reduced-motion contract every hook honors; binds tome-chrome scroll behavior and tome-blocks-extras block animation.
- [Blocks Core](https://wabbit.com/docs/packages/blocks-core): Core primitives for the Tome block system — the block/bundle registry, defineBlock/defineBundle factories, variant-aware admin components (BlockPicker, VariantPicker), and the thumbnail pipeline; upstream dependency for every tome-blocks-* pack.
- [Blocks](https://wabbit.com/docs/packages/blocks): Meta-package re-exporting all first-party @wabbit/tome-blocks-* bundles with a registerAll() convenience function; install for one-import access to every Tome block.
- [Blocks House](https://wabbit.com/docs/packages/blocks-house): Shared house primitives (fields, motion helpers, and SCSS/CSS style contracts) ported from wabbit-site-core's block system, plus one pilot block — full-bleed-interstitial. Dependency substrate for promoting Wabbit's site-local blocks into sellable Tome packs, not itself a sellable pack.
- [Blocks Console (Preview)](https://wabbit.com/docs/packages/blocks-console): Shared presentational cores for console-style blocks, plus the console role names (surface, ink, line, accent hues, status) a skin maps to its own palette. Dependency substrate for block packs, not itself a sellable pack.
- [Blocks Gallery](https://wabbit.com/docs/packages/blocks-gallery): Shared browse + detail + code-viewer + entitlement-aware gallery for @wabbit/tome-blocks-* packs. Ships NO Payload collections. The /components subpath imports CSS modules and is browser/Next.js-only — do NOT import it from Payload config or generate:types evaluation paths.
- [Admin](https://wabbit.com/docs/packages/admin): Tome-native admin shell that wraps Payload's admin. Sales-tool v0.
- [Admin Pro](https://wabbit.com/docs/packages/admin-pro): Tier-gated pro extensions for @wabbit/tome-admin. Self-gates on TOME_ADMIN_LICENSE_KEY at registration time.
- [Chrome](https://wabbit.com/docs/packages/chrome): Tome platform site-shell layer — Header global factory + 7 navbar variants + Footer global factory + 11 footer variants + variant registries + scroll-direction hide/reveal. Distinct from @wabbit/tome-blocks (page-section content) by consumption shape: chrome is configured once per site via Payload globals, not composed per page.

## Commerce engine

- [Economy](https://wabbit.com/docs/packages/economy): Tome economy layer — orders, payments, prices, subscriptions, payment provider adapters (Stripe + Free), Stripe webhook handler, checkout + subscription-checkout actions, order-complete and subscription-lifecycle event buses.
- [Catalog](https://wabbit.com/docs/packages/catalog): Tome catalog layer — products, attributes, categories, vendor scoping, ProductTypeRegistry.
- [Fulfillment (Preview)](https://wabbit.com/docs/packages/fulfillment): Tome fulfillment layer — shipping addresses (GDPR-registered), shipments, warehouse stock with an append-only adjustment trail, a flat-rate shipping seam, and a deferred tax adapter seam.
- [Storefront (Preview)](https://wabbit.com/docs/packages/storefront): Tome storefront layer — a cookie-token shopping cart (guest and member, merged at sign-in, swept on a TTL), a single store-facts global, a public non-leaky stock-availability projection, a product listing that joins catalog, prices and availability, and cookie-aware Next.js server actions. Money stays in economy, stock in fulfillment, product nouns in catalog.
- [Crowdfund (Preview)](https://wabbit.com/docs/packages/crowdfund): Tome crowdfunding layer — campaigns, reward tiers, pledges, and the all-or-nothing settlement job (save card at pledge, charge off-session at deadline).
- [Affiliates](https://wabbit.com/docs/packages/affiliates): Tome affiliates layer — referral attribution by link and promotion code, commission snapshots held through the refund window, refund reversal with carry-forward, and payouts through the economy payouts extension.
- [Economy Authnet](https://wabbit.com/docs/packages/economy-authnet): Authorize.net payment provider adapter for @wabbit/tome-economy — Accept Hosted checkout + card capture, ARB recurring subscriptions, X-ANET-Signature webhook verification, outbound refunds, and a nightly ARB reconciliation job. A generic high-risk-friendly processor adapter for verticals Stripe's own policy excludes (e.g. cannabis-adjacent commerce) — no vertical-specific logic lives here.

## CRM & Marketing engine

- [Crm](https://wabbit.com/docs/packages/crm): Tome CRM layer — contacts, accounts, opportunities, activities with sister-layer integration adapters (intake, deals, realtime, territory, ai-stubs).
- [Deals](https://wabbit.com/docs/packages/deals): Tome Deals layer — deal lifecycle engine with artifact-type registry (quotes, proposals, SOWs, retainer agreements) and CRM cascade integration.
- [Intake](https://wabbit.com/docs/packages/intake): Tome intake layer — the canonical lead-capture submit pipeline (verify → persist → route → notify) behind a single submitIntakeAction composition seam. Render is owned by @wabbit/tome-forms.
- [Marketing](https://wabbit.com/docs/packages/marketing): Tome marketing layer — campaigns, audiences, provider adapters (Encharge + Kit), webhook ingest, and per-prospect prototype-site linkage.
- [Forms](https://wabbit.com/docs/packages/forms): Tome native form engine — admin-authored form definitions, multi-step runtime, conditional-logic expression evaluator, server-authoritative zod validation, and tomeForm block render surface.

## Learning engine

- [Lms](https://wabbit.com/docs/packages/lms): Tome LMS v2 layer — courses, lessons, topics, academies, enrollment/progress tracking, quizzes, assignments, certifications, gamification tie-ins, instructor scheduling, and student-facing data helpers.
- [Lms Ui](https://wabbit.com/docs/packages/lms-ui): React render layer for the Tome LMS — lesson player (progress bar, course shell, curriculum sidebar, quiz/assignment renderers, notes panel) and the LearnerShell app shell; depends on @wabbit/tome-lms.
- [Gamification](https://wabbit.com/docs/packages/gamification): Generic gamification substrate — points ledger, badges, and achievements; extracted from @wabbit/tome-lms, consumed directly by @wabbit/tome-rpg for XP derivation.

## Directory engine

- [Directory](https://wabbit.com/docs/packages/directory): Tome local-directory layer — markets, listings, claims, reviews, favorites, promotions, and an inbound menu-item seam, plus a defineListingType registry and a DirectoryTenantPolicy contract so vertical rules live in the consuming site, never in the layer.

## Community engine

- [Org](https://wabbit.com/docs/packages/org): Tome organization layer — org structure (divisions, teams, groups), members, role hierarchy, events, campaigns, and documents, with configurable terminology and 40+ permission grants.
- [Accounts](https://wabbit.com/docs/packages/accounts): Tome multi-tenant SaaS accounts layer — accounts, memberships (seats/roles), projects, and an account-scoped authority resolver built on the converged @wabbit/tome-core permission engine.
- [Workflow](https://wabbit.com/docs/packages/workflow): Tome workflow engine — a generic approval/transition state machine consolidating the accounts governance CAS claim primitive and the deals declarative transition table + side-effect registry. Engine + factory helpers only, no collections.
- [Ledger (Preview)](https://wabbit.com/docs/packages/ledger): Community-currency ledger for Tome sites — currency, wallet, and transaction collections with a strong integrity contract: balance floors, atomic transfers, idempotency keys, and an audit trail. Separate from @wabbit/tome-economy, which handles real-money payments.

## Realtime & 3D

- [Webgl](https://wabbit.com/docs/packages/webgl): Tome's WebGL/WebGPU layer — shared background canvas, opt-in page transitions, inline experience blocks, and a TSL shader utility library, driven by Payload's block system.
- [Engine (Preview)](https://wabbit.com/docs/packages/engine): Domain-neutral real-time runtime substrate — a Three.js scene/actor loop, an input pipeline (devices to bindings to profiles to transforms), vanilla Zustand stores, a trace recorder, math/flight utilities, and an optional React binding layer; zero @wabbit/* dependencies.

## Platform services

- [Ai (Preview)](https://wabbit.com/docs/packages/ai): Tome AI layer — BYOK per-member encrypted credential store + Anthropic adapter + runFeature narration runtime.
- [Print](https://wabbit.com/docs/packages/print): Tome platform print layer — document assembly, template registry, and Pandoc-driven PDF generation for structured reports.

## Blocks & themes

- [Blocks Content Writer](https://wabbit.com/docs/packages/blocks-content-writer): Free-tier editorial and content blocks for blogs and long-form writing — archive, blog, post hero, related posts, and the editorial opener/sidenote/footnotes/figure/colophon/bridge family.
- [Blocks Marketing Starter](https://wabbit.com/docs/packages/blocks-marketing-starter): Free-tier landing-page and marketing blocks: high-impact hero, feature hero, CTA, logo slider, pricing, banner, FAQ, testimonial, exhibit, and the stop viewer, switch tally, proof ledger, terminal steps, layer stack, term rows and slat deck bands.
- [Blocks Agency Essentials](https://wabbit.com/docs/packages/blocks-agency-essentials): Starter-tier agency blocks for business and portfolio sites — about, contact, team roster, gallery, timeline, stats, split-view, media, and a contact form.
- [Commerce Blocks](https://wabbit.com/docs/packages/blocks-catalog-pack): Pro-tier catalog/e-commerce blocks — product card, product grid, category strip, price table, inventory badge, and featured product, with optional live-data hydration from @wabbit/tome-catalog.
- [Blocks Editorial Pack](https://wabbit.com/docs/packages/blocks-editorial-pack): Pro-tier editorial presentation blocks for data-forward, branded layouts — data hero, editorial section/spread, compare columns, feature, info panel, message panel, metric strip, split panel, status board, and text reveal.
- [Learning Blocks](https://wabbit.com/docs/packages/blocks-lms-pack): Pro-tier LMS blocks — course card, lesson list, progress bar, quiz summary, instructor card, and enrollment CTA, with optional live-data hydration from @wabbit/tome-lms.
- [Org Blocks](https://wabbit.com/docs/packages/blocks-org-pack): Render-ready organization/community blocks — division card, member card, member grid, event calendar, live event list, event list item, org chart, document link, and campaign banner; static except the event list, which reads @wabbit/tome-org events through a server wrapper.
- [Blocks Dossier Pack](https://wabbit.com/docs/packages/blocks-dossier-pack): Case-file, evidence, and ledger register blocks for proof-heavy sections — dossier grids, spec sheets, exhibit cards, and record ledgers, built on the house field/motion/style primitives.
- [Blocks Campaign Pack (Preview)](https://wabbit.com/docs/packages/blocks-campaign-pack): Campaigns and giving: a hero, a running total, giving and pledge tiers, a give form, membership cards, the case, terms and a closing band.
- [Blocks Cinema Pack](https://wabbit.com/docs/packages/blocks-cinema-pack): Video and full-bleed display blocks for cinematic sections — cinema feature, trigger tile, video wall/spread, chaptered walkthrough, scrub story, testimonial rail, ambient band, scene plates and captions, statement band, media panel, and pull interlude, built on the house field/motion/style/video primitives.
- [Blocks Extras](https://wabbit.com/docs/packages/blocks-extras): Interim free grab-bag bundle absorbing the ~50 blocks not yet curated into a purpose-built pack — heroes, content/prose sections, cards, showcases, lexical embeds, and layout primitives; slated for re-homing into tiered bundles.
- [Blocks Industrial Theme](https://wabbit.com/docs/packages/blocks-industrial-theme): Industrial treatment for Tome catalog/LMS blocks — safety-yellow accents, charcoal type, motorsport-italic chrome. Opt-in via [data-tome-theme='industrial'] + one stylesheet import; restyles the neutral pack blocks through their public hooks without forking them.
- [Blocks Directory Pack](https://wabbit.com/docs/packages/blocks-directory-pack): Pro-tier local-directory blocks — map, listing grid, listing detail, promotions rail, claim CTA, review form, age-gate explainer, and mega menu — with query-driven server hydration from @wabbit/tome-directory and a pluggable map/geocoder provider seam (MapLibre, Google, Mapbox).
- [Blocks Proposal Pack](https://wabbit.com/docs/packages/blocks-proposal-pack): Proposal design blocks for Tome — cover, letter, chapter divider, stat strip, statement band, media spread, two-doors, checklist, monthly path, offer cards, a service-level plan picker, optional add-ons, numbered asks, and a closing letter for building client-facing proposals with @wabbit/tome-deals. Included free with deals.
- [Blocks Local Pack (Preview)](https://wabbit.com/docs/packages/blocks-local-pack): Local-business blocks for Tome — a menu or price list (photo card grid, printed ledger, home teaser), a live open-now status line, a find-us logistics band with keyless directions and today-highlighted hours, and a facilities guide with an illustrated site plan and per-facility open state — that read the site's @wabbit/tome-local business profile, with inline fields as the fallback. Free with any theme.
- [Blocks Portfolio Pack (Preview)](https://wabbit.com/docs/packages/blocks-portfolio-pack): Portfolio blocks for Tome: a featured-project hero and a filterable work index (a ledger of job-numbered projects with a thumbnail column, type and status chips with live counts and a count line), rendered from the @wabbit/tome-portfolio layer's project records or from inline entries. Built for the Studio theme.
- [Blocks Practice Pack (Preview)](https://wabbit.com/docs/packages/blocks-practice-pack): Practice blocks for Tome: a need picker, service cards and price rows, a people row with accepting status, offices with live open state and who is seen where, a person or topic page header, credentials, reviewed lines, a first-visit steps list and a book-or-call closing block, rendered from the @wabbit/tome-practice layer's people, offerings, topics and groups. Neutral by default and restyled through public data-* hooks.
- [Longform](https://wabbit.com/docs/packages/longform): Tome platform long-form editorial reading-kit — 16 Payload blocks extracted from the upstream Signal set: drop caps, epigraphs, chapter dividers, asides, accordions, tables, spoilers, and cross-reference cards.
- [Dispatch](https://wabbit.com/docs/packages/dispatch): Tome platform dispatch layer — 8 blocks that frame user content as transmission, record, or intel product: CommIntercept, CommsTranscript, ClassificationBanner, LogHeader, Redacted, SystemAlert, AmbientAudio, ThreatPanel.
- [Readout](https://wabbit.com/docs/packages/readout): Tome platform structured-data display layer — 9 operational-console blocks for labeled data, personnel rosters, metric grids, progress bars, and sensor readouts. Generic across all domains; optional COP aesthetic peer.
- [Blocks Storefront Pack (Preview)](https://wabbit.com/docs/packages/blocks-storefront-pack): Storefront blocks for physical goods: the client cart store, the bag button and count, the bag drawer, and the real Add to bag control that catalog tiles and hero chips pick up. Prices always come from the server.
- [Blocks Signal Theme](https://wabbit.com/docs/packages/blocks-signal-theme): Addon-tier Signal editorial theme — 39 Star-Citizen-flavored operational blocks, 23 of them offered (ship cards, personnel cards, comm intercepts, classification banners, threat panels) for org and editorial sites; ships bundled inside @wabbit/tome-sc.
- [Cop](https://wabbit.com/docs/packages/cop): COP (Common Operating Picture) theme — operational/intel visual tokens activated by data-tome-theme="cop" (data-tome-pack="cop" is a deprecated alias), with a ThemeManifest and a ./register subpath for the Tome theme registry.
- [Theme Groundwork (Preview)](https://wabbit.com/docs/packages/theme-groundwork): Groundwork, a Tome theme for trades, home services and appointment-based local businesses: warm paper grounds, Zilla Slab display numerals, accent-as-punctuation, dark claims and estimate bands. Four palettes (Timber, Brick, Harbor, Field) plus dark, self-hosted OFL fonts, activated by data-tome-theme="groundwork".
- [Theme Counsel (Preview)](https://wabbit.com/docs/packages/theme-counsel): Counsel, a Tome theme for law firms and other advisors whose credibility is their product: a well-set printed document, Source Serif 4 with small-caps meta and light numerals, ruled ledgers, margin notes and a compliance label on every proof block. Four palettes (Vellum, Chancery, Sage, Slate) plus dark, self-hosted OFL fonts, activated by data-tome-theme="counsel".
- [Theme Table (Preview)](https://wabbit.com/docs/packages/theme-table): Table, a Tome theme for places people visit (restaurants and cafés first, then bars, bakeries, venues and boutique retail): a Now Bar that answers "are you open", a photo-first menu with prices on the dish's baseline, Fraunces with palette-set axes and tabular Work Sans figures, the accent as punctuation. Two palettes (Linen, Garden) plus dark, self-hosted OFL fonts, activated by data-tome-theme="table".
- [Theme Folio (Preview)](https://wabbit.com/docs/packages/theme-folio): Folio, a Tome theme for coaches, counselors, consultants and authors whose business is themselves: a book by its author with the author writing in the margins. Piazzolla with Alegreya Sans, old-style folios, soft paper radii and colored inks. Four palettes (Deckle, Clay, Heath, Lamplight) plus derived opposite modes, self-hosted OFL fonts, activated by data-tome-theme="folio".
- [Theme Shelf (Preview)](https://wabbit.com/docs/packages/theme-shelf): Shelf, a Tome theme for small-batch shops: a printed catalog that happens to take your order. Anybody for the shop (expanded display, tabular figures) with Spectral for the maker, the shelf line and the chamfered edition tag, color by commerce role. Four palettes (Bisque, Stone, Pantry, Smoke) plus derived opposite modes, self-hosted OFL fonts, activated by data-tome-theme="shelf".
- [Theme Roster (Preview)](https://wabbit.com/docs/packages/theme-roster): Roster, a Tome theme for businesses that run classes on a timetable and sell a term of them: gymnastics, dance, swim, martial arts, camps and preschools. A printed gym timetable in one darker frame, a level stripe as the one recurring mark, Bricolage Grotesque with Atkinson Hyperlegible Next, and one filled action per page. Four palettes (Chalk, Lane, Camp, Sprout) plus derived opposite modes, self-hosted OFL fonts, activated by data-tome-theme="roster".
- [Theme Studio (Preview)](https://wabbit.com/docs/packages/theme-studio): Studio, a Tome theme for studios whose portfolio is the sales argument: architects, design-build firms, interior designers, landscape architects, photographers and small creative agencies. The work speaks: a photograph is the largest thing on every page, type behaves like a caption and never sits on it, and a numbered project archive with a facts block carries the rest. Archivo at three widths, a mark-only accent, one dark band for the one ask. Four palettes (Gallery, Concrete, Black Box, Blueprint) plus derived opposite modes, a self-hosted OFL font, activated by data-tome-theme="studio".
- [Theme Commons (Preview)](https://wabbit.com/docs/packages/theme-commons): Commons, a Tome theme for organizations that belong to their members: neighborhood associations, tenant and parent groups, co-ops, community halls, clubs and small nonprofits. The record is the design: a reference number leads every figure, a filed document backs every claim, the Running Total is one honest line over a flat bar, and the one dark band is the ask. Schibsted Grotesk and Inclusive Sans, a lantern-and-bottle-green default (Grove), four palettes plus derived opposite modes, self-hosted OFL fonts, activated by data-tome-theme="commons".
- [Theme Grounds (Preview)](https://wabbit.com/docs/packages/theme-grounds): Grounds, a Tome theme for places people visit: parks and athletic complexes, event venues, marinas and waterfronts, historic districts and market halls. The signboard is the design: a key plate names every place, the Today Board says what is on and when, a drawn plan sits beside the list, and the booking desk is one honest form. Overpass and Figtree, an indigo-and-coral default (Pennant), four palettes plus derived opposite modes, self-hosted OFL fonts, activated by data-tome-theme="grounds".
- [Theme Schoolroom (Preview)](https://wabbit.com/docs/packages/theme-schoolroom): Schoolroom, a Tome theme for people who teach for a living and want their school to look like a school, not a funnel: the marketing site and the learner app in one look. The outcome is the first screen, the syllabus is typeset, the lesson player keeps a margin, and the transcript, certificate and checkout are the same quiet page. Literata and Lexend, a graphite-and-highlighter default (Margin), four palettes plus derived opposite modes (Night School opens dark), self-hosted OFL fonts, activated by data-tome-theme="schoolroom".
- [Theme Rounds (Preview)](https://wabbit.com/docs/packages/theme-rounds): Rounds, a Tome theme for health and wellness practices, counseling and group practices included: know who is treating you. Every colored section is an inset rounded card, the header is two tiers (live status and the emergency line, then a large phone number and a fixed Book), the need picker sits on the field color, and the first visit is a connected journey. Gabarito and Instrument Sans, four palettes (Morning, Blush, Stride and Dusk) with derived opposite modes, self-hosted OFL fonts, activated by data-tome-theme="rounds".

## Operations vertical

- [Sc (Vertical)](https://wabbit.com/docs/packages/sc): Tome Star Citizen wrapper — fleet management, ship database, RSI integration, SC locations, gameplay activity taxonomy, operation/force templates, squadrons, task force coordination, and military rank presets over @wabbit/tome-org. Bundles the SC block pack, Signal editorial theme, and the COP military design-token theme.
- [Blocks Sc Pack (Vertical)](https://wabbit.com/docs/packages/blocks-sc-pack): Addon-tier Star Citizen org blocks extending the Signal theme — fleet summary, task force roster, op briefing panel, RSI handle card, and signal-hero-sc; self-contained, zero dependency on @wabbit/tome-sc's collection layer.
- [Planning (Preview)](https://wabbit.com/docs/packages/planning): Military map symbology for Tome sites — MIL-STD-2525 / APP-6 symbol and modifier registries, preset shortcuts, server-side symbol rendering, a reference grid, and collision-free label placement for mission-planning maps.

## Machine-readable

- [Tome docs MCP server](https://wabbit.com/docs/mcp): read-only MCP endpoint (Streamable HTTP, no auth) with listPackages, getPackage, readDoc, searchDocs, getBlockUsage and suggestBlocks over this reference
- [Block usage](https://wabbit.com/docs/blocks/usage.json): every block's when-to-use, avoid-when, pairs-with and page types as JSON, with a page-type index