@cavuno/board 1.25.0 → 1.27.0

package/skills/cavuno-board-theme/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: cavuno-board-theme
+description: Board branding with @cavuno/board/theme — map the board's stored theme (16 semantic colors × light/dark + typography from board.context().theme) onto shadcn CSS variables, resolve the color-scheme mode, and build the Google Fonts request. Use when wiring the app shell, dark mode, or brand styling for a tenant frontend.
+---
+
+# Theme: board branding → shadcn tokens
+
+`@cavuno/board/theme` maps the board's stored theme onto the canonical
+shadcn token vocabulary as CSS-variable overrides. One contract, two
+consumers: the dashboard edits the board theme; agents restyle through the
+standard shadcn theme file — both end up in the same tokens.
+
+## When to use
+
+- The app shell/root layout of any tenant frontend, once.
+- Wiring dark mode or brand fonts.
+
+## When not to use
+
+- Component-level styling — write normal Tailwind/shadcn classes; they pick
+  the overridden tokens up automatically.
+
+## Wire it once at the shell
+
+```ts snippet
+import { boardThemeToCss, themeMode, googleFontsUrl } from '@cavuno/board/theme';
+
+const context = await board.context();
+const css = boardThemeToCss(context.theme);   // ':root {…}' + '.dark {…}'
+const mode = themeMode(context.theme);        // 'light' | 'dark' | 'system'
+const fontsHref = googleFontsUrl(context.theme); // one <link>, or null
+```
+
+Inject `css` in a `<style>` AFTER the static theme stylesheet so the
+overrides win; render nothing when it's empty (a null theme means the app's
+default theme applies untouched). Apply `mode` by toggling the `.dark`
+class (`system` = follow `prefers-color-scheme`).
+
+## The mapping is the contract
+
+All 16 board color keys are consumed — a coverage golden in-monorepo
+asserts neither the hosted board nor this module drops one. Standard
+shadcn tokens carry the core (background/foreground, card, popover,
+primary, secondary, muted, accent, destructive, border, input, ring);
+the four keys shadcn has no standard token for ship as
+`--contrast-background`, `--contrast-foreground`, `--foreground-subtle`,
+`--foreground-disabled`, plus `--foreground-error`.
+
+## Anti-patterns
+
+```ts no-check
+// NEVER hardcode brand colors in components — they bypass the board theme:
+<button style={{ background: '#7c3aed' }} />
+// NEVER re-map theme keys ad hoc per page; the shell mapping is the single source.
+// NEVER fetch fonts per-family — googleFontsUrl builds ONE deduped request.
+```
+
+## Out of scope — do not invent exports
+
+No color math (hover/pressed derivation, contrast checking — the hosted
+dashboard owns palette design), no per-component theme props, no CSS-in-JS
+runtime. The module emits strings; the app owns injection.
+
+## Verify
+
+- [ ] A board with a custom theme renders its brand color on primary
+      buttons and focus rings; a board without one renders the app default.
+- [ ] Dark palette applies under `.dark` and `mode` drives the class.
+- [ ] The Google Fonts request appears once, covering sans + heading.

package/skills/manifest.json

@@ -1,6 +1,20 @@
 {
-  "version": "1.25.0",
+  "version": "1.27.0",
   "skills": [
+    {
+      "name": "cavuno-board-account",
+      "description": "Candidate account self-service with the @cavuno/board SDK — me.retrieve/delete, the candidate profile (merge-patch update, handle availability), experience/education CRUD, skills/languages full-replace, avatar upload, resume upload with async parse polling, and notification preferences plus the anonymous token unsubscribe. Use when building account, profile-edit, onboarding, or notification-settings pages for a signed-in board user.",
+      "path": "skills/cavuno-board-account/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-applications",
+      "description": "The native apply flow with the @cavuno/board SDK — jobs.apply (signed-in or guest), attaching a resume via jobs.uploadApplicationResume, the jobs.myApplication \"have I applied?\" check, managing submitted applications (me.applications list/retrieve/updateFacts/withdraw), and saved jobs (me.savedJobs). Use when building an apply form, an application-tracker page, or a save-job button.",
+      "path": "skills/cavuno-board-applications/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-auth",
       "description": "Authenticate board users with the @cavuno/board SDK — register, login, refresh, logout, email verification and password reset. Covers bearer-JWT storage modes, the deliberate no-auto-refresh-on-401 rule (and single-flight handling), and the server-side httpOnly-cookie pattern that keeps tokens out of the browser.",
@@ -8,6 +22,13 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-blog",
+      "description": "Build the blog with the @cavuno/board SDK — post archives (blog.posts.list with tagSlug/authorSlug/featured), the post page (blog.posts.retrieve + adjacent + similar), blog.tags and blog.authors, and free-text blog.search. Covers the summary-vs-detail split (html on the single read only), cursor pagination, slug-change redirects (redirected/newSlug), and the SEO fields the API actually returns.",
+      "path": "skills/cavuno-board-blog/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-client",
       "description": "Create and configure the @cavuno/board client — baseUrl and the pk_ board identifier, global headers, request/response hooks, per-call FetchOptions caching passthrough, the client.fetch escape hatch, and the rule that keeps one shared instance safe under SSR.",
@@ -15,6 +36,13 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-companies",
+      "description": "Build company surfaces with the @cavuno/board SDK — the companies index (companies.list / companies.search with the market filter), the company profile (companies.retrieve, listJobs, similar), the markets sub-surface (companies.markets + markets.resolve with its 308 redirectTo), and company salary pages (companies.salaries + salaries.category). Covers PublicCompany vs PublicCompanyDetail and envelope pagination.",
+      "path": "skills/cavuno-board-companies/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-errors",
       "description": "Handle errors and access gating with the @cavuno/board SDK — the BoardApiError shape, the typed guards (isNotFound, isUnauthorized, isValidationError, isRateLimited, isForbidden, isConflict), and the board-password flow (isBoardPasswordRequired → password.verify → X-Board-Access grant).",
@@ -22,6 +50,34 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-filters",
+      "description": "The canonical listing-filter vocabulary and URL search-param parsing with @cavuno/board/filters — remote/employment/seniority/sort sets, localized seniority labels, and parseListingFilters for jobs-listing routes. Use when building listing pages, filter sidebars, sort dropdowns, or validating listing URL params.",
+      "path": "skills/cavuno-board-filters/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-format",
+      "description": "Display formatting for board frontends with @cavuno/board/format — salary ranges, seniority/employment/remote labels, location labels, dates, and the board-language salary lexicon. Use when rendering job cards, detail pages, or salary figures, and whenever a value like salaryMin/salaryTimeframe/seniority needs to become display text.",
+      "path": "skills/cavuno-board-format/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-job-alerts",
+      "description": "Build job-alert flows with the @cavuno/board SDK — the anonymous double-opt-in surface (jobAlerts.subscribe/confirm/resendConfirmation + HMAC-token manage/unsubscribe/resubscribe/updatePreference/deletePreference) and the authenticated board.me.alerts CRUD. Covers which surface to use when, how the manage token rides, which filters actually scope delivery, and the full-replace update trap.",
+      "path": "skills/cavuno-board-job-alerts/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-job-posting",
+      "description": "Build the anonymous \"Post a job\" funnel with the @cavuno/board SDK — jobPosting.plans, create and its status-discriminated JobPostingResult (checkout / published / pending_approval / invoice_sent), logo upload + fetchLogoByDomain, and the email-verified billing helpers (checkBilling, sendBillingVerification, getBillingOptions, checkSubscriptionEntitlements).",
+      "path": "skills/cavuno-board-job-posting/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-jobs",
       "description": "Browse, search, and render jobs with the @cavuno/board SDK — jobs.list, jobs.search, jobs.retrieve, jobs.similar. Covers the slim card vs full job shapes, storefront pagination (count/limit/offset + opaque cursor), filters, and the candidate-paywall gatedCount.",
@@ -29,6 +85,34 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-messaging",
+      "description": "Build the board-user messaging inbox with the @cavuno/board SDK — me.conversations (list, unreadCount, retrieve, listMessages, start, reply, markRead, archive), me.messages (edit, unsend, report), me.blocks. Covers the polled-REST contract (no realtime transport in v1), visibility-aware polling, the unread badge, and read receipts.",
+      "path": "skills/cavuno-board-messaging/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-paywall",
+      "description": "Build the candidate job-access paywall with the @cavuno/board SDK — anonymous offer reads (paywall.offers), the gated browse experience (gatedCount on job lists), the embedded Stripe checkout mount kit (me.access.checkout → retrieveCheckout → grant), and the billing portal (me.access.portal for recurring grants).",
+      "path": "skills/cavuno-board-paywall/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-salaries",
+      "description": "Build salary pages with the @cavuno/board SDK — salaries.titles/skills/locations (list + retrieve + cross-axis .locations/.location/.titles/.skills), salaries.companies.list. Covers the sourceSlug/canonicalSlug 308 contract, the { locale } overlay, aggregate field shapes (avg/median/percentile bands + jobCount), and why salary math must never be recomputed client-side.",
+      "path": "skills/cavuno-board-salaries/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-seo",
+      "description": "Structured data + head builders for board frontends with @cavuno/board/seo — Google for Jobs JobPosting JSON-LD, breadcrumbs, blog Article/ProfilePage, salary-page Occupation/FAQ structured data, and listing <head> descriptors. Use when building a job-detail, listing, blog, or salary page and it needs JSON-LD or SEO meta tags, or whenever \"structured data\", \"rich results\", or \"Google for Jobs\" comes up.",
+      "path": "skills/cavuno-board-seo/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-setup",
       "description": "End-to-end orchestrator for building a headless Cavuno job board with the @cavuno/board SDK. Start here after `npx @cavuno/board setup` copies the skills — detect the framework, wire the client, render board context, jobs browsing and detail, board-user auth and saved jobs, handle errors and access gating, then verify.",
@@ -36,12 +120,33 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-sitemap",
+      "description": "Build the board's sitemap with @cavuno/board/sitemap — the hosted 8-bucket model (marketing, jobs taxonomies, job details, companies, salaries, blog), 45k chunking, XML rendering, and the buildBucketUrls walker that enumerates a board's content through the BoardSdk with the hosted SEO rules built in (feature gating, ≥5-job thin-content floor, pagination backstops). Use when adding /sitemap.xml and /sitemap/:file routes to a custom board frontend.",
+      "path": "skills/cavuno-board-sitemap/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
+    {
+      "name": "cavuno-board-smoke-test",
+      "description": "Runtime verification for a wired Cavuno board frontend — literal curl probes against the Board API plus per-surface behavioral checks and a mandatory production-build pass. Run after cavuno-board-setup finishes, after upgrading @cavuno/board, or whenever board wiring is suspect. Type checks are not enough for board wiring.",
+      "path": "skills/cavuno-board-smoke-test/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-tanstack-start",
       "description": "TanStack-Start-on-Cloudflare-Workers reference wiring for a headless Cavuno board — SSR loaders calling @cavuno/board server-side, the session held in an __Host- httpOnly cookie owned by the app, a single-flight refresh helper, and FetchOptions cache passthrough on Workers.",
       "path": "skills/flavors/tanstack-start/SKILL.md",
       "framework": "tanstack-start",
       "category": "flavor"
+    },
+    {
+      "name": "cavuno-board-theme",
+      "description": "Board branding with @cavuno/board/theme — map the board's stored theme (16 semantic colors × light/dark + typography from board.context().theme) onto shadcn CSS variables, resolve the color-scheme mode, and build the Google Fonts request. Use when wiring the app shell, dark mode, or brand styling for a tenant frontend.",
+      "path": "skills/cavuno-board-theme/SKILL.md",
+      "framework": null,
+      "category": "core"
     }
   ]
 }