Launching Typeconf 0.3.0 and Storage Platform

Today we're announcing a new version of Typeconf which brings new API and three cool features!

Unified Configuration API

If you've followed me on Twitter or Bluesky, I've been constantly saying how hard it is to come up with a truly elegant and simple API. Now, I can say that we've achieved a significant progress on this. Instead of having separate methods like readConfigFromFile or getLocalJSONConfig, we have a single, unified API:

import { readConfig } from "@typeconf/sdk";
// import { readConfig } from "@typeconf/react-sdk"; // if you're using React
import { ProjectConfig } from "@/configs/types/all";

// path to your config.ts file without the extension
const config: ProjectConfig = readConfig("path/to/your-config");

This new API:

• Works for all supported configuration sources (our managed TypeScript configs, JSONs, Typeconf Storage)
• Provides consistent behavior across different SDKs

Hopefully this is intuitive, but we'll continue to simplify further!

Runtime Validation with Zod

We've integrated Zod validation library, into Typeconf. This addition brings:

• Runtime type checking for your configurations
• Type inference from your validation schemas

Now every time when you read configs under the hood they are validated through Zod schema. Schemas are also available to use in your app - you can import them from configs/types/all.zod.ts.

Multiple Configs Support

Typeconf now supports managing multiple configuration files within a single config directory. This feature allows you to:

• Organize different environments (development, staging, production) in separate files
• Split large configurations into logical modules
• Maintain different configurations for various deployment scenarios

// configs/dev.config.ts
export const config = {
  apiUrl: "http://localhost:3000",
  debug: true,
};

// configs/prod.config.ts
export const config = {
  apiUrl: "https://api.example.com",
  debug: false,
};

Typeconf Storage - Free Cloud Storage for Dynamic Configuration

The most exciting addition is Typeconf Storage - a free cloud storage service specifically designed for configuration management. You can upload your config values and change them without redeployment. We support revisions for configs, so you can experiment quickly and fearlessly.

To get started with Typeconf Storage use our CLI:

npx @typeconf/typeconf cloud update-config-value path/to/configs/your.config.ts

Upgrading SDK

To upgrade to Typeconf 0.3.0:

npm install @typeconf/sdk@latest
# or
npm install @typeconf/react-sdk@latest

For detailed documentation on all new features, visit our documentation.

We're excited to see how you'll use these new features to make your configs type-safe! As always, we welcome your feedback and suggestions for future improvements.