Packages

Packages for integrators

The @blueforge-studio/* packages BlueForge builds its own products with. Use them alongside the platform or on your own stack.

The packr registry

The @blueforge-studio scope is published to packr at https://api.packr.blueforge.studio, not to npmjs.org. Map the scope in your project's .npmrc; installs authenticate with a packr token in PACKR_TOKEN (set it in CI too — a build without it cannot resolve the scope).

.npmrc

@blueforge-studio:registry=https://api.packr.blueforge.studio
//api.packr.blueforge.studio/:_authToken=${PACKR_TOKEN}

bash

pnpm add @blueforge-studio/blueforge-sidecar-schemas
# or: npm install @blueforge-studio/blueforge-sidecar-schemas

Need a packr token? Ask us. Versions move often; pin a range in package.json and let your lockfile hold the exact version.

Catalog and sidecars

Validate what you send to the registry.

@blueforge-studio/blueforge-sidecar-schemas
Zod schemas, types and merge helpers for blueforge.product.yml, blueforge.features.yml and the rest of the sidecar family.
@blueforge-studio/sync-to-storage
Provider-agnostic declarative asset sync on top of service-storage, with manifest dedupe.

Marketing UI

Build a product site without writing the chrome.

@blueforge-studio/marketing-kit
Slot-driven marketing site components — header, hero, features and pricing grids, footer, newsletter form, CTA band — with no bundled copy.
@blueforge-studio/feature-gate
Server-side withFeatureGate and a client <FeatureGate> component, decoupled from any auth or tenant implementation.

Service adapters

Provider-neutral factories: pick the backend with environment variables, swap it without touching call sites. Use BlueForge's services or your own providers.

@blueforge-studio/service-auth
createAuthService with Better Auth, Supabase, Clerk and console adapters.
@blueforge-studio/service-email
createEmailService with Resend, Mailstack and console adapters.
@blueforge-studio/service-newsletter
createNewsletterService with a remote adapter for newsletter-os.
@blueforge-studio/service-storage
createStorageService with B2, R2, MinIO, Supabase and in-memory adapters.
@blueforge-studio/service-error-tracking
createErrorTracker with Sentry, self-hosted and console adapters.
@blueforge-studio/service-analytics
createAnalyticsService with PostHog, Vercel, MarketingOS, Postgres and console adapters.
@blueforge-studio/service-payments
Provider-neutral checkout, billing portal, refunds, webhooks and billing data.
@blueforge-studio/service-git
createGitService with GitHub, GitLab, forge-git and console adapters.
@blueforge-studio/service-deployer
Deploy service factory with ForgeHosting, Vercel and console adapters behind one interface.
@blueforge-studio/service-i18n
createI18nService with i18n-os, next-intl-static and console adapters.
@blueforge-studio/service-queue
createQueueService with BullMQ, QStash and in-memory adapters.
@blueforge-studio/service-cache
createCacheService with Upstash, ioredis and in-memory adapters.

Identity and tenancy

Work with forge-auth organizations from your app.

@blueforge-studio/tenancy
Tenancy SDK for forge-auth organizations — getSession, requireRole, requireEntitlement, webhooks and Drizzle helpers.

Internationalization

Ship more than one language.

@blueforge-studio/i18n-tools
Monorepo-aware i18n tooling: locale discovery, validation, AI translation, sync and coverage reporting.

Quality and audits

The checks BlueForge runs on its own products.

@blueforge-studio/screen-audit
Screen audit SDK — element captures, multi-device, AI vision evaluation, visual regression diffing.
@blueforge-studio/user-flows
One source per user flow, driving Playwright E2E, screen-audit and diagram output.
@blueforge-studio/a11y-audit
Accessibility audit runner — scans a site with axe-core and emits per-page and site-wide reports.
@blueforge-studio/lighthouse-audit
Lighthouse performance, SEO and PWA audits over many URLs, with markdown reports.