How fern-api/fern works
Fern turns API definitions into generated SDKs and other artifacts; its README’s main workflow is to initialize a project with an API specification and run fern generate. The repository also contains a Rust CLI generator runtime and documents hosted API documentation and AI Search. The graph separates those product capabilities from the sampled SDK-generation pipeline. Some documented capabilities lack implementation excerpts here, so their internal links are omitted rather than inferred.
Main entry points: app.rs Generated API CLI · runPipeline.ts SDK pipeline · GeneratorPipeline.ts Fern CLI · parser.rs OpenAPI parser
Components 22
Generation workflow
- API definition
- Fern CLI
packages/cli/cli-v2/src/sdk/generator/GeneratorPipeline.ts - SDK pipeline
generators/cli/src/runPipeline.ts - SDK template
generators/cli - Generated SDK
- Post-generation
packages/generator-cli/src/pipeline/PostGenerationPipeline.ts
Generator engines
- Generator base
generators/base/src - Language SDK generators
generators - CLI generator
generators/cli/src - Spec generators
generators/openapi
Generated CLI runtime
- Generated API CLI
generators/cli/sdk/src/openapi/app.rs - OpenAPI parser
generators/cli/sdk/src/openapi/parser.rs - API model
generators/cli/sdk/src/openapi/discovery.rs - Command builder
generators/cli/sdk/src/openapi/commands.rs - Request executor
generators/cli/sdk/src/openapi/executor.rs - Authentication
generators/cli/sdk/src/auth/mod.rs - HTTP client
generators/cli/sdk/src/http.rs - Request profiles
generators/cli/sdk/src/profiles/mod.rs
Developer platform
- API documentation
- AI Search
Other components
- API developer
- CLI user
Connections 20
- API developer → API definition: defines API
README.md - API developer → Fern CLI: runs generation
README.md - API definition → Fern CLI: provides input
README.md - Fern CLI → SDK pipeline: invokes pipeline
- SDK pipeline → SDK template: copies template
generators/cli/src/runPipeline.ts - SDK pipeline → Generated SDK: generates SDK
generators/cli/src/runPipeline.ts - SDK pipeline → Post-generation: runs follow-up
- Generator base → Language SDK generators: supports generation
- API developer → API documentation: builds docs
README.md - API developer → AI Search: offers search
README.md - CLI user → Generated API CLI: invokes commands
- Generated API CLI → OpenAPI parser: loads spec
generators/cli/sdk/src/openapi/app.rs - OpenAPI parser → API model: produces model
generators/cli/sdk/src/openapi/parser.rs - Generated API CLI → Command builder: builds commands
generators/cli/sdk/src/openapi/app.rs - Generated API CLI → Request executor: dispatches request
generators/cli/sdk/src/openapi/app.rs - Generated API CLI → Authentication: configures auth
generators/cli/sdk/src/openapi/app.rs - Generated API CLI → Request profiles: configures profiles
generators/cli/sdk/src/openapi/app.rs - Request executor → HTTP client: sends requests
- API developer → Spec generators: exports OpenAPI
README.md - API developer → Language SDK generators: selects SDK
README.md