Reference
Packages
Understand the consolidated package story, the scaffolder, and the import surface the current product expects developers to use.
What developers can install today
The public docs route should reflect the package surface that actually exists in the repository now.
clivly
npm install clivly
clivly/sdkcreateClivlySDK, defineClivlyConfig
clivly/drizzlefromDrizzle, discoverFromDrizzle
clivly/vitedev-server boot hook
clivly/auth/*adapter entry points
@clivly/chat-widget
the embeddable widget
@clivly/auth-clerk
optional adapter peer
The CLI is not a separate install — `npx clivly` runs the bin this package already ships.
| Package | Purpose | Notes |
|---|---|---|
clivly | Runtime imports + CLI | Consolidated runtime package plus the CLI command developers keep using after setup. |
create-clivly | App creation bootstrap | Scaffolder for npm create clivly, wrapping the init flow for greenfield starts. |
@clivly/sdk | Cloud connection SDK | Package-local reference for WebSocket presence, HTTP fallback, sync, serverless, and diagnostics. |
@clivly/chat-widget | Visitor chat widget | Embeddable React and script-tag widget with a host-side session bootstrap route. |
@clivly/auth-clerk | Clerk auth adapter | Clerk adapter for host session resolution. |
@clivly/auth-workos | WorkOS auth adapter | WorkOS adapter for host session resolution. |
@clivly/auth-better-auth | better-auth adapter | better-auth adapter with no runtime dependency lockstep. |
@clivly/core | Contracts + config | Entity config and schema discovery contracts that the runtime shares. |
Imports that matter
The consolidated import story is important because the runtime package and CLI now share the same public mental model.
imports.ts
import { createClivlySDK, defineClivlyConfig } from "clivly/sdk";
import { fromDrizzle } from "clivly/drizzle";
import { clivlyVite } from "clivly/vite";
import { createClerkAuthAdapter } from "clivly/auth/clerk";
import { createWorkOSAuthAdapter } from "clivly/auth/workos";
import { createBetterAuthAdapter } from "clivly/auth/better-auth";