Files
civitai__civitai/docs/creator-studio-overview.md
T
briant 373f499810 docs(creator-studio): add implementation plan, per-page specs, and buzz-client handoff
- creator-studio-plan.md: scope, decisions, architecture (buzz already a service;
  in-process monetization module; ClickHouse analytics), main-app add/remove,
  phasing, and the consolidated "Questions for Justin" review-pass list.
- creator-studio-overview.md + creator-studio/ per-page specs (models, dashboard,
  analytics, earnings, licensing, settings, join) + index with a cross-cutting
  decisions table.
- buzz-client-handoff.md: state of the @civitai/buzz work for a fresh session.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-02 11:47:07 -06:00

2.0 KiB

Creator Studio — Overview

A new SvelteKit spoke app at creator.civitai.com — the single home for managing everything a creator earns from (licensing fees, model access, earnings & analytics). Any logged-in user can access it; member-only actions are gated on subscription tier.

Full plan: creator-studio-plan.md.

Packages

New package — just one:

  • @civitai/buzz (built) — server-side client for the buzz service (transactions, balances, typed endpoint methods). Lifted out of buzz.service.ts. Server-only. (Not the analytics path — see ClickHouse below.)

Creator-studio modules (in-app, NOT packages — extract only when a 2nd app needs them):

  • monetizationsetLicensingFee, bulkSetLicensingFee, setUnlimitedAccess, member-tier gate. On @civitai/db (kysely) + @civitai/buzz. No stacking (backend), no ClickHouse. → package at the full-cutover consolidation.
  • analytics reads — ClickHouse queries via @civitai/clickhouse.

Existing packages — consumed:

  • @civitai/ui — shadcn-svelte components + theme
  • @civitai/auth — spoke guard (any authenticated user; tier read for member gating)
  • @civitai/db (+ @civitai/db-schema) — kysely reads/writes
  • @civitai/clickhouserequired: all analytics/earnings read from ClickHouse (daily aggregates / materialized views), not the buzz service

Pages

v1:

  • / — Dashboard / overview
  • /models — Model management (access toggles, per-version licensing fee, sell-indefinitely)
  • /earnings/analytics — Basic analytics
  • /earnings — Earnings by source (via @civitai/buzz)
  • /licensing — Licensing fees (bulk editor)
  • /settings — Payout & settings (Tipalti status, tier)
  • /join — Membership upsell (for non-members)

Deferred (not v1):

  • /shop, /shop/items/[id] — Shop management (built in the main app first, transfers in later)

= designer-prioritised for v1.