Documentation
This is the reference for the Tome package library — the block packs, themes, and platform packages we build Wabbit sites on, and that we publish for you to build with too. The per-package pages below are generated from the source we actually ship, so what you read here matches what you install.
Newer packages, and their guides, land here as we write them. If something you expect is missing, it is probably still being written rather than hidden.
Start here
- Get startedStand up a new Tome site from the starter.
- Commerce quickstartWire products, checkout, and entitlements.
- CRM & Marketing quickstartCapture leads and run sequences.
- Learning quickstartBuild courses and lessons.
- Directory quickstartRun a local directory with listings, claims, and reviews.
- Community quickstartStand up member organizations, approvals, and a community currency.
- Width & breakout doctrineHow layout width and full-bleed breakout work.
- VersioningHow package versions and updates work.
- RoadmapWhere the platform is headed.
- ChangelogWhat shipped, across the library.
Packages
- Stable
- Semver-committed and running in production. Breaking changes only in a major version.
- Preview
- Published and supported, but the API may still change between minor versions. Pin the minor.
- Vertical
- Built for a specific kind of organization. Documented in public, licensed on request.
Foundation
The runtime every Tome site is built on: core, UI, motion, chrome, the block system, and the admin shell.
Corev1.21.1StableFoundation 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.
@wabbit/tome-coreLocalv0.1.1PreviewTome local-business layer — a timezone-correct, browser-safe open-state utility (split shifts, dated overrides, named schedules) and a LocalBusiness JSON-LD builder that takes a neutral input.@wabbit/tome-localUiv0.19.0StableToken-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.@wabbit/tome-uiMotionv0.5.0StableClient-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.@wabbit/tome-motionBlocks Corev0.35.0StableCore 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.@wabbit/tome-blocks-coreBlocksv0.35.0StableMeta-package re-exporting all first-party @wabbit/tome-blocks-* bundles with a registerAll() convenience function; install for one-import access to every Tome block.@wabbit/tome-blocksBlocks Housev0.10.0StableShared 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.@wabbit/tome-blocks-house1 blockBlocks Consolev0.1.2PreviewShared 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.@wabbit/tome-blocks-consoleBlocks Galleryv1.10.0StableShared 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.@wabbit/tome-blocks-galleryAdminv0.9.0StableTome-native admin shell that wraps Payload's admin. Sales-tool v0.@wabbit/tome-adminAdmin Prov0.2.3StableTier-gated pro extensions for @wabbit/tome-admin. Self-gates on TOME_ADMIN_LICENSE_KEY at registration time.@wabbit/tome-admin-proChromev0.19.0StableTome 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.@wabbit/tome-chromeCommerce engine
Products, orders, and checkout, plus the add-ons that extend them: fulfillment, affiliates, crowdfunding, and a second payment processor.
Economyv0.13.2StableTome 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.
@wabbit/tome-economyCatalogv1.6.1StableTome catalog layer — products, attributes, categories, vendor scoping, ProductTypeRegistry.@wabbit/tome-catalogFulfillmentv0.1.4PreviewTome 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.@wabbit/tome-fulfillmentCrowdfundv0.2.1PreviewTome crowdfunding layer — campaigns, reward tiers, pledges, and the all-or-nothing settlement job (save card at pledge, charge off-session at deadline).@wabbit/tome-crowdfundAffiliatesv0.6.2StableTome 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.@wabbit/tome-affiliatesEconomy Authnetv0.2.1StableAuthorize.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.@wabbit/tome-economy-authnetCRM & Marketing engine
Contacts, forms, intake, marketing sequences, and deals: quotes, proposals, and statements of work.
Crmv0.6.3StableTome CRM layer — contacts, accounts, opportunities, activities with sister-layer integration adapters (intake, deals, realtime, territory, ai-stubs).
@wabbit/tome-crmDealsv0.7.2StableTome Deals layer — deal lifecycle engine with artifact-type registry (quotes, proposals, SOWs, retainer agreements) and CRM cascade integration.@wabbit/tome-dealsIntakev0.3.4StableTome 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.@wabbit/tome-intakeMarketingv0.5.1StableTome marketing layer — campaigns, audiences, provider adapters (Encharge + Kit), webhook ingest, and per-prospect prototype-site linkage.@wabbit/tome-marketingFormsv0.6.1StableTome native form engine — admin-authored form definitions, multi-step runtime, conditional-logic expression evaluator, server-authoritative zod validation, and tomeForm block render surface.@wabbit/tome-formsLearning engine
Courses, lessons, enrollments, and the points and badges that come with them.
Lmsv0.23.6StableTome LMS v2 layer — courses, lessons, topics, academies, enrollment/progress tracking, quizzes, assignments, certifications, gamification tie-ins, instructor scheduling, and student-facing data helpers.
@wabbit/tome-lmsLms Uiv0.10.6StableReact 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.@wabbit/tome-lms-uiGamificationv0.3.4StableGeneric gamification substrate — points ledger, badges, and achievements; extracted from @wabbit/tome-lms, consumed directly by @wabbit/tome-rpg for XP derivation.@wabbit/tome-gamificationDirectory engine
A local directory: markets, listings, owner claims, reviews, and promotions.
Community engine
Member organizations, approval flows, a community currency, and multi-tenant accounts.
Orgv0.14.6StableTome organization layer — org structure (divisions, teams, groups), members, role hierarchy, events, campaigns, and documents, with configurable terminology and 40+ permission grants.
@wabbit/tome-orgAccountsv0.5.1StableTome 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.@wabbit/tome-accountsWorkflowv0.3.2StableTome 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.@wabbit/tome-workflowLedgerv0.2.2PreviewCommunity-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.@wabbit/tome-ledgerRealtime & 3D
WebGL scenes, page transitions, and shader blocks, plus a small runtime for interactive and game-like experiences.
Webglv0.8.2StableTome'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.
@wabbit/tome-webglEnginev0.2.3PreviewDomain-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.@wabbit/tome-enginePlatform services
Cross-cutting services: print-ready PDF output and bring-your-own-key AI.
Blocks & themes
The visual library: block packs, editorial kits, and themes you compose pages from.
Blocks Content Writerv0.34.1StableFree-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.
@wabbit/tome-blocks-content-writer10 blocksBlocks Marketing Starterv0.35.0StableFree-tier landing-page and marketing blocks — high-impact hero, feature hero, CTA, logo slider, pricing, banner, FAQ, testimonial, and exhibit.@wabbit/tome-blocks-marketing-starter9 blocksBlocks Agency Essentialsv0.35.0StableStarter-tier agency blocks for business and portfolio sites — about, contact, team roster, gallery, timeline, stats, split-view, media, and a contact form.@wabbit/tome-blocks-agency-essentials10 blocksCommerce Blocksv0.28.5StablePro-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.@wabbit/tome-blocks-catalog-pack6 blocksBlocks Editorial Packv0.35.0StablePro-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.@wabbit/tome-blocks-editorial-pack12 blocksLearning Blocksv0.28.5StablePro-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.@wabbit/tome-blocks-lms-pack6 blocksOrg Blocksv0.6.4StableRender-ready organization/community blocks — division card, member card, member grid, event calendar, event list item, org chart, document link, and campaign banner; static today, scaffolded for future @wabbit/tome-org hydration.@wabbit/tome-blocks-org-pack8 blocksBlocks Dossier Packv0.14.0StableCase-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.@wabbit/tome-blocks-dossier-pack25 blocksBlocks Campaign Packv0.5.4PreviewCrowdfunding-campaign-page blocks — a hero, a live-progress strip, a reward-tier wall, a terms strip, and a closing band — for a single-page all-or-nothing pledge campaign.@wabbit/tome-blocks-campaign-pack5 blocksBlocks Cinema Packv0.4.5StableVideo 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.@wabbit/tome-blocks-cinema-pack13 blocksBlocks Extrasv0.35.0StableInterim pro-tier 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.@wabbit/tome-blocks-extras36 blocksBlocks Industrial Themev0.2.1StableIndustrial 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.@wabbit/tome-blocks-industrial-themeBlocks Directory Packv1.7.0StablePro-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).@wabbit/tome-blocks-directory-pack8 blocksBlocks Proposal Packv0.5.0StableProposal design blocks for Tome — cover, letter, chapter divider, stat strip, statement band, media spread, two-doors, checklist, monthly path, offer cards, numbered asks, and a closing letter for building client-facing proposals with @wabbit/tome-deals. Included free with deals.@wabbit/tome-blocks-proposal-pack13 blocksLongformv0.8.0StableTome 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.@wabbit/tome-longformDispatchv0.3.0StableTome platform dispatch layer — 8 blocks that frame user content as transmission, record, or intel product: CommIntercept, CommsTranscript, ClassificationBanner, LogHeader, Redacted, SystemAlert, AmbientAudio, ThreatPanel.@wabbit/tome-dispatchReadoutv0.3.0StableTome 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.@wabbit/tome-readoutBlocks Signal Themev0.35.0StableAddon-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.@wabbit/tome-blocks-signal-theme23 blocksCopv0.2.2StableCOP (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.@wabbit/tome-copOperations vertical
Domain packages for operational communities: fleets, assets, squadrons, and military map symbology. Available on request.
Scv0.4.13VerticalTome 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.
@wabbit/tome-scBlocks Sc Packv0.28.5VerticalAddon-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.@wabbit/tome-blocks-sc-packPlanningv0.1.1PreviewMilitary 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.@wabbit/tome-planning