![\"@smooai/config](\".github/banner.png\")
\n\n \n
\n ![\"npm\"](\"https://img.shields.io/npm/v/@smooai/config?style=for-the-badge&color=00A6A6&label=npm&logo=npm&logoColor=white&labelColor=020618\")
![\"Smoo](\"https://img.shields.io/badge/Smoo_AI-platform-00A6A6?style=for-the-badge&labelColor=020618\"){kind=icon}
![\"license\"](\"https://img.shields.io/badge/license-MIT-F49F0A?style=for-the-badge&labelColor=020618\"){kind=icon}
\n ![\"TypeScript\"](\"https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white\"){kind=icon}
![\"Python\"](\"https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white\"){kind=icon}
![\"Rust\"](\"https://img.shields.io/badge/Rust-000000?style=flat-square&logo=rust&logoColor=white\"){kind=icon}
![\"Go\"](\"https://img.shields.io/badge/Go-00ADD8?style=flat-square&logo=go&logoColor=white\"){kind=icon}
![\".NET\"](\"https://img.shields.io/badge/.NET-512BD4?style=flat-square&logo=dotnet&logoColor=white\"){kind=icon}
![\"Kotlin\"](\"https://img.shields.io/badge/Kotlin-7F52FF?style=flat-square&logo=kotlin&logoColor=white\"){kind=icon}
![\"Swift\"](\"https://img.shields.io/badge/Swift-F05138?style=flat-square&logo=swift&logoColor=white\"){kind=icon}
\n Features · \n Install · \n Quick start · \n Platform\n
\n\n---\n\n> Define your config once with Zod (or Valibot, ArkType, Effect), and read it with full type inference everywhere — public config, server-only secrets, and live feature flags. Rename a key and every call site is a compile error, not a 3 AM page. Native clients in TypeScript, Python, Rust, Go, and .NET all read from the same source of truth.\n\n> 📣 **The CLI moved.** Use `smoo config` from the [smooth repo](https://github.com/SmooAI/smooth) for all operator commands (login, get, set, list, push, pull, diff, init, etc.). The standalone `smooai-config` CLI that used to live in this repo is deprecated and being deleted (SMOODEV-1411). **The runtime library `@smooai/config` (TypeScript / Python / Rust / Go / .NET, consumed via `secretConfig.get(...)` / `publicConfig.get(...)` / `featureFlag.get(...)`) is unchanged** — only the operator CLI surface moved to Rust in the smooth repo. (`smoo …` is the th binary's platform namespace; `th smoo …` and the old `th config …` spelling also work.)\n\n## ✨ Features\n\n- **Three tiers, one schema** — public config, secrets, and feature flags defined once with Zod/Valibot/ArkType/Effect, validated everywhere they're read.\n- **Strongly-typed keys** — `defineConfig()` gives you `PublicConfigKeys`, `SecretConfigKeys`, and `FeatureFlagKeys` with full inference. Mis-typed keys fail at compile time, not at runtime.\n- **Any environment, any key** — the same API for `development`, `staging`, and `production`. Override per-stage without touching code.\n- **Zero-latency cold starts** — values are baked into the bundle as env vars (Next.js, Vite) or resolved in-memory from a local runtime (server). No network round-trip on the hot path.\n- **Browser, server, framework-native** — the same typed keys read cleanly from React client components, Server Components, Next.js, Vite, or plain Node.\n- **Live feature flags** — toggled from the dashboard without a redeploy, but still typed.\n- **Native clients in every language** — TypeScript, Python, Rust, Go, and .NET (C#) server SDKs all read from the same source of truth, plus Kotlin and Swift mobile SDKs for the public-only app surface ([ADR-074 mobile runtime mode](docs/Mobile-Runtime-Mode-Spec.md)).\n\n## Languages / SDKs\n\nPick the SDK that matches your service. Every **server** client reads the same schema, the same encrypted bundle, and the same config API — so a key renamed in one language ripples through all of them. The two **mobile** SDKs (📱) speak a deliberately narrower, public-only surface — no secrets ever ship to a device.\n\n| SDK | One-liner | README |\n| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |\n| **TypeScript** | Primary SDK. Schema definition, Next.js / Vite plugins, server runtime, React hooks. | [`README.md` (this file)](#-quick-start-typescript) |\n| **Python** | Pydantic-validated schemas, sync `ConfigClient`, `LocalConfigManager` + `ConfigManager`, baked runtime. | [`python/README.md`](python/README.md) |\n| **Go** | Native struct schemas, thread-safe `ConfigClient` / `ConfigManager`, baked-blob runtime. | [`go/config/README.md`](go/config/README.md) |\n| **Rust** | `JsonSchema`-derived schemas, async `ConfigClient`, sync `ConfigManager`, baked-blob runtime. | [`rust/config/README.md`](rust/config/README.md) |\n| **.NET** | Roslyn source-generated typed keys, OAuth2 `SmooConfigClient`, AES-GCM `SmooConfigRuntime`. Thinner surface than the other server SDKs — see [the capability notes](#sdk-capability-notes). | [`dotnet/README.md`](dotnet/README.md) |\n| **Kotlin** 📱 | Mobile runtime mode (ADR-074): baked public bundle + live flag/limit evaluation, offline-safe, **no secrets on device**. Ships via JitPack commit pin — not on Maven Central yet. | [`kotlin/`](kotlin/) · [spec](docs/Mobile-Runtime-Mode-Spec.md) |\n| **Swift** 📱 | Mobile runtime mode (ADR-074): same surface as Kotlin (`publicValue`, `evaluateFlag`, `evaluateLimit`). Consumed via SPM pinned to a revision — no version tag yet. | [`swift/`](swift/Sources/SmooAIConfig/) · [spec](docs/Mobile-Runtime-Mode-Spec.md) |\n\nThe five server SDKs release in **version lockstep** — v6.11.3 on npm, PyPI, crates.io, and NuGet, with the matching `v6.11.3` git tag for the Go module, all cut from the same commit (verified against each registry 2026-08-20). The mobile SDKs version separately (commit-pinned; see below).\n\n## 📦 Install\n\n```sh\npnpm add @smooai/config\n```\n\n## 🚀 Quick Start (TypeScript)\n\n### 1. Define your configuration schema\n\nUse `defineConfig()` with any [StandardSchema](https://github.com/standard-schema/standard-schema)-compliant library (Zod, Valibot, ArkType, Effect Schema) or the built-in `StringSchema`, `BooleanSchema`, and `NumberSchema` helpers:\n\n```typescript\n// .smooai-config/config.ts\nimport { defineConfig, StringSchema, BooleanSchema, NumberSchema } from '@smooai/config';\nimport { z } from 'zod';\n\nconst config = defineConfig({\n publicConfigSchema: {\n apiBaseUrl: z.string().url(),\n maxRetries: NumberSchema,\n enableDebug: BooleanSchema,\n },\n secretConfigSchema: {\n databaseUrl: z.string().url(),\n apiKey: StringSchema,\n },\n featureFlagSchema: {\n enableNewUi: BooleanSchema,\n betaFeatures: BooleanSchema,\n },\n});\n\nexport default config;\n\n// Extract typed key objects for use throughout your app\nexport const { FeatureFlagKeys, PublicConfigKeys, SecretConfigKeys } = config;\n```\n\n`defineConfig()` automatically maps camelCase keys to `UPPER_SNAKE_CASE`:\n\n```typescript\nFeatureFlagKeys.ENABLE_NEW_UI; // \"ENABLE_NEW_UI\"\nPublicConfigKeys.API_BASE_URL; // \"API_BASE_URL\"\nSecretConfigKeys.DATABASE_URL; // \"DATABASE_URL\"\n```\n\n### 2. Add to `tsconfig.json`\n\n```json\n{\n \"compilerOptions\": { ... },\n \"include\": [\"src/**/*\", \".smooai-config/**/*.ts\"]\n}\n```\n\n## 📖 Next.js Integration\n\n### Inject config into `next.config.ts`\n\nUse `withSmooConfig()` to inject feature flags and public config as `NEXT_PUBLIC_` environment variables, with per-stage overrides:\n\n```typescript\n// next.config.ts\nimport { withSmooConfig } from '@smooai/config/nextjs/withSmooConfig';\n\nconst nextConfig = withSmooConfig({\n default: {\n featureFlags: { enableNewUi: false, betaFeatures: false },\n publicConfig: { apiBaseUrl: 'https://api.smooai.com', maxRetries: 3 },\n },\n development: {\n featureFlags: { enableNewUi: true },\n publicConfig: { apiBaseUrl: 'http://localhost:3000' },\n },\n});\n\nexport default nextConfig;\n```\n\nThis sets environment variables like `NEXT_PUBLIC_FEATURE_FLAG_ENABLE_NEW_UI=true` and `NEXT_PUBLIC_CONFIG_API_BASE_URL=http://localhost:3000` based on the current stage.\n\n### Read config in React client components\n\n```tsx\nimport { getClientFeatureFlag, getClientPublicConfig } from '@smooai/config/client';\n\nfunction MyComponent() {\n const isNewUi = getClientFeatureFlag('enableNewUi');\n const apiUrl = getClientPublicConfig('apiBaseUrl');\n\n if (!isNewUi) return\n Built by Smoo AI — AI built into every product.\n
\n","readmeFilename":"README.md"}