@smooai/client-shared

SmooAI's cross-runtime client shared library — the single home for primitives every SmooAI client app needs identically, regardless of language.

This repo absorbs and supersedes the standalone @smooai/ui crate. ui is now one module among siblings (auth, llm, future) inside a single smooai-client-shared Rust crate, with matching @smooai/client-shared npm / NuGet / PyPI packages planned.

Why one crate, not many

A SmooAI Rust client (smooblue, observability-studio, th, th admin, …) typically needs the same three things:

1. Design tokens + monogram — so the UI looks like SmooAI.
2. Auth — Supabase user OAuth (browser login) AND M2M client_credentials grant (service accounts), with one shared on-disk CredentialsStore.
3. LLM access — exchanges a user session JWT for an org-scoped llm.smoo.ai LLM bearer so every user's spend attributes to their org's TPM budget.

Each of these has been re-implemented in every consumer at least once. This crate makes them one dependency:

smooai-client-shared = { version = "0.1", features = ["ui", "auth"] }

Feature flags

The ui feature is the default and inherits the same dependency tree as the old smooai-ui crate — zero runtime deps, no_std-compatible. Smooblue and observability-studio can swap smooai-ui for smooai-client-shared without pulling any new transitive dependencies.

Feature	Adds	Pulls
ui (default)	STYLES, MONOGRAM_SVG, tokens::*	nothing
auth	Supabase OAuth, M2M, CredentialsStore	tokio, reqwest, axum, serde
llm	JWT → llm.smoo.ai org-session exchange	(implies auth)

Layout

~/dev/smooai/client-shared/
├── shared/                # cross-language source of truth
│   ├── styles.css         # OKLCH tokens + base component CSS
│   ├── monogram.svg       # smoo monogram
│   └── tokens.json        # tokens as plain JSON
├── rust/                  # smooai-client-shared (crates.io)
│   ├── Cargo.toml
│   └── src/
│       ├── lib.rs
│       ├── ui/            # lifted from smooai-ui
│       ├── auth/          # Supabase OAuth + M2M + storage  (feature = "auth")
│       └── llm/           # JWT → LLM session exchange      (feature = "llm")
├── src/                   # @smooai/client-shared (npm) — future
├── dotnet/                # SmooAI.ClientShared (NuGet) — future
├── python/                # smooai-client-shared (PyPI) — future
└── LICENSE  README.md

Migrating from smooai-ui

Replace

smooai-ui = "0.1"

with

smooai-client-shared = "0.1"   # default features include "ui" — same surface

and swap imports:

// before
use smooai_ui::{STYLES, MONOGRAM_SVG, tokens};

// after
use smooai_client_shared::ui::{STYLES, MONOGRAM_SVG, tokens};

The ui module is API-compatible with smooai-ui 0.1 — every const and sub-module lives at the same relative path under ui::.

For one release cycle, the legacy smooai-ui crate continues to publish as a thin re-export shim (pub use smooai_client_shared::ui::*) with a deprecation warning. Yanks after the cycle.

Related repos

• @smooai/ui — the original design-system-only crate. Will become a deprecation shim then retire.
• @smooai/smooth — the th CLI; consumes client-shared::{auth, llm} for login + LLM session.
• smooblue, observability-studio — Dioxus desktop apps; consume client-shared::ui.

License

MIT — see LICENSE.