Configo.Design.Generation

Configo.Design.Generation

Out-of-process JSON schema generator for Configo.

You do not reference this package directly. It is an implementation detail of the configo schema generate tool.

What it is

When you run configo schema generate, the tool:

1. Runs your application so Configo.Design can discover which configuration sections are bound to which CLR types, writing a small bindings manifest.
2. Generates a tiny throwaway project that targets your application's runtime, references your application's compiled output, and references this package.
3. Runs that throwaway project. It reads the manifest, loads your option types on your application's own runtime, and generates the appsettings.schema.json using NJsonSchema.

Because generation runs on your application's runtime (compiled against your app and the ASP.NET Core shared framework), the .NET host resolves your application's full dependency closure — including shared-framework types such as System.Threading.RateLimiting — exactly as it does when your app runs.

This keeps NJsonSchema entirely out of your application: it is only ever referenced by the throwaway generator project, never by your app or by Configo.Design.

Why a separate package?

NJsonSchema requires a live System.Type to generate a schema. The only place your option types load reliably is on your application's own runtime. Shipping the generator as its own package lets the configo tool reference it from a throwaway project that runs there — instead of the tool trying to load your application's assemblies into its own (different) runtime, which is fragile and fails for shared-framework types.