@vennyx/soliconfig

Official TypeScript / JavaScript SDK for soliconfig — encrypted secrets (.env) and Remote Config (feature flags) for multi-tenant apps.

The core is framework-agnostic (works in Bun, Node 18+, Deno, browsers, edge runtimes). React bindings ship as a separate, optional entry point.

Install

npm install @vennyx/soliconfig
# or: bun add @vennyx/soliconfig

Quick start

import { SoliconfigClient } from '@vennyx/soliconfig'

const client = new SoliconfigClient({ apiKey: 'sc_...' })

// Remote Config — server-evaluated flags/values
const flags = await client.config.fetch({ environment: 'production' })
const showBanner = flags.get('show_banner', false)

// Secrets — end-to-end encrypted .env values
const secrets = await client.secrets.pull({ environment: 'production' })

React

import { SoliconfigClient } from '@vennyx/soliconfig'
import { SoliconfigProvider, useConfigValue } from '@vennyx/soliconfig/react'

const client = new SoliconfigClient({ apiKey: 'sc_...' })

function App() {
  return (
    <SoliconfigProvider client={client} environment="production">
      <Banner />
    </SoliconfigProvider>
  )
}

function Banner() {
  const show = useConfigValue('show_banner', false)
  return show ? <div>👋</div> : null
}

react is an optional peer dependency — the core entry never imports it.

Configuration

| Option | Type | Default | Description | | --------- | ---------- | ------------------------------ | ------------------------------------ | | apiKey | string | — | Project API key (sc_...), required | | baseUrl | string | https://api.soliconfig.com | Override for self-hosted / staging | | fetch | FetchLike| global fetch | Inject a custom fetch implementation |

Links

• Docs: https://soliconfig.com/docs
• Dashboard: https://soliconfig.com

License

MIT © Vennyx