Getting Started

1. Install the dependencies

   npm

   npm install @layerfig/config

   yarn

   yarn add @layerfig/config

   bun

   bun install @layerfig/config

   pnpm

   pnpm add @layerfig/config

2. Define your files

   • Directoryapp

     • Directoryconfig

       • base.json
       • live.json
     • Directorysrc

       • …
       • Directoryconfig

         • index.ts
         • schema.ts
   index.ts

   import { ConfigBuilder } from "@layerfig/config";
   
   export const config = new ConfigBuilder({
     validate: (finalConfig, z) =>
       z.object({
           appURL: z.url(),
           port: z.coerce.number().int().int().positive(),
         })
         .parse(finalConfig),
   })
     .addSource("base.json")
     .addSource("live.json")
     .build();

   base.json

   {
     "appURL": "http://localhost:3000",
     "port": 3000
   }

   live.json

   {
     "appURL": "https://live.my-app.company"
   }

3. Use your type-safe config

   Now, you can access the configuration anywhere in your server-side code:

   import { config } from "./config";
   
   config.appURL; // string => "https://live.my-app.company"
   config.port; // number => 3000