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

For AI agents

This reference is also an MCP server at https://wabbit.com/docs/mcp. Connect Claude, Cursor or any MCP client to search it, read package docs and pick blocks for a page. It's read-only and needs no sign-in. To add it to Claude Code: claude mcp add --transport http tome-docs https://wabbit.com/docs/mcp

We count MCP tool calls and the names of the packages looked up. We never record what you search for, or who is asking.

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.35.0StableFoundation 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.7.0PreviewTome 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.@wabbit/tome-localPortfoliov0.4.0PreviewTome 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.@wabbit/tome-portfolioMapsv0.1.2PreviewTome 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.@wabbit/tome-mapsPracticev0.2.0PreviewTome 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.@wabbit/tome-practiceUiv0.22.3StableToken-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.2StableClient-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.49.4StableCore 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.50.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.3StableShared 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.3PreviewShared 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.11.5StableShared 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.11.2StableTome-native admin shell that wraps Payload's admin. Sales-tool v0.@wabbit/tome-adminAdmin Prov0.2.5StableTier-gated pro extensions for @wabbit/tome-admin. Self-gates on TOME_ADMIN_LICENSE_KEY at registration time.@wabbit/tome-admin-proChromev0.31.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-chrome

Commerce engine

Products, orders, and checkout, plus the add-ons that extend them: fulfillment, affiliates, crowdfunding, and a second payment processor.

Economyv0.19.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.10.0StableTome catalog layer — products, attributes, categories, vendor scoping, ProductTypeRegistry.@wabbit/tome-catalogFulfillmentv0.3.3PreviewTome 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-fulfillmentStorefrontv0.6.0PreviewTome 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.@wabbit/tome-storefrontCrowdfundv0.2.3PreviewTome 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.7.0StableTome 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.3.0StableAuthorize.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-authnet

Blocks & themes

The visual library: block packs, editorial kits, and themes you compose pages from.

Blocks Content Writerv0.49.4StableFree-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.50.1StableFree-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.@wabbit/tome-blocks-marketing-starter16 blocksBlocks Agency Essentialsv0.50.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.49.4StablePro-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-pack7 blocksBlocks Editorial Packv0.49.8StablePro-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.49.4StablePro-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-pack8 blocksOrg Blocksv0.11.0StableRender-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.@wabbit/tome-blocks-org-pack9 blocksBlocks Dossier Packv0.22.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.6.2PreviewCampaigns and giving: a hero, a running total, giving and pledge tiers, a give form, membership cards, the case, terms and a closing band.@wabbit/tome-blocks-campaign-pack8 blocksBlocks Cinema Packv0.4.10StableVideo 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.49.7StableInterim 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.@wabbit/tome-blocks-extras38 blocksBlocks Industrial Themev0.2.3StableIndustrial 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.9.1StablePro-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.6.4StableProposal 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.@wabbit/tome-blocks-proposal-pack14 blocksBlocks Local Packv0.14.0PreviewLocal-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.@wabbit/tome-blocks-local-pack10 blocksBlocks Portfolio Packv0.2.1PreviewPortfolio 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.@wabbit/tome-blocks-portfolio-pack5 blocksBlocks Practice Packv0.3.0PreviewPractice 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.@wabbit/tome-blocks-practice-pack13 blocksLongformv0.9.2StableTome 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.2StableTome 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.2StableTome 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 Storefront Packv0.1.4PreviewStorefront 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.@wabbit/tome-blocks-storefront-pack8 blocksBlocks Signal Themev0.49.4StableAddon-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.5StableCOP (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-copTheme Groundworkv0.2.3PreviewGroundwork, 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".@wabbit/tome-theme-groundworkTheme Counselv0.2.0PreviewCounsel, 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".@wabbit/tome-theme-counselTheme Tablev0.1.4PreviewTable, 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".@wabbit/tome-theme-tableTheme Foliov0.2.0PreviewFolio, 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".@wabbit/tome-theme-folioTheme Shelfv0.1.3PreviewShelf, 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".@wabbit/tome-theme-shelfTheme Rosterv0.2.0PreviewRoster, 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".@wabbit/tome-theme-rosterTheme Studiov0.1.4PreviewStudio, 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".@wabbit/tome-theme-studioTheme Commonsv0.1.3PreviewCommons, 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".@wabbit/tome-theme-commonsTheme Groundsv0.1.4PreviewGrounds, 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".@wabbit/tome-theme-groundsTheme Schoolroomv0.1.3PreviewSchoolroom, 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".@wabbit/tome-theme-schoolroomTheme Roundsv0.1.2PreviewRounds, 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".@wabbit/tome-theme-rounds