Skip to navigation

Welcome to Fern!

Everything you need to build the best developer experience
View as Markdown

Table examples

Basic markdown table

NameTypeRequiredDescription
organizationstringYesYour organization’s unique identifier
versionstringYesThe Fern CLI version to use
urlstringYesThe public URL for your docs site
titlestringNoBrowser tab title for your docs
faviconstringNoPath to your favicon file

Searchable table

ParameterTypeDefaultDescription
backgroundlight | darklightBackground color scheme
primarycolor hex#000000Primary brand color
accentcolor hex—Accent color for links and highlights
logopath—Path to your logo image
faviconpath—Path to your favicon
fontstringsystemCustom font family name
border-radiusnone | sm | md | lgmdBorder radius for UI elements
sidebar-widthpx value300pxWidth of the navigation sidebar
content-widthpx value720pxMax width of the content area
header-heightpx value64pxHeight of the top navigation bar

Paginated table

SDKLanguageStatusInstall
TypeScriptTypeScript / JavaScriptGAnpm install @your-org/sdk
PythonPython 3.8+GApip install your-org
JavaJava 11+GAMaven / Gradle
GoGo 1.19+GAgo get github.com/your-org/sdk-go
RubyRuby 2.7+Betagem install your-org
C#.NET 6+BetaNuGet
PHPPHP 8.0+BetaComposer
SwiftSwift 5.7+Coming soonSwift Package Manager
KotlinKotlin 1.7+Coming soonMaven Central
RustRust 1.65+Coming soonCargo
ScalaScala 2.13+Plannedsbt
ElixirElixir 1.13+PlannedHex
1–10 of 12
SDKLanguageStatusInstall
TypeScriptTypeScript / JavaScriptGAnpm install @your-org/sdk
PythonPython 3.8+GApip install your-org
JavaJava 11+GAMaven / Gradle
GoGo 1.19+GAgo get github.com/your-org/sdk-go
RubyRuby 2.7+Betagem install your-org
C#.NET 6+BetaNuGet
PHPPHP 8.0+BetaComposer
SwiftSwift 5.7+Coming soonSwift Package Manager
KotlinKotlin 1.7+Coming soonMaven Central
RustRust 1.65+Coming soonCargo
ScalaScala 2.13+Plannedsbt
ElixirElixir 1.13+PlannedHex
1–5 of 12

Paginated + searchable table

MethodEndpointAuthDescription
GET/plantsOptionalList all plants in the store
POST/plantsRequiredCreate a new plant listing
GET/plants/{id}OptionalGet a plant by ID
PATCH/plants/{id}RequiredUpdate an existing plant
DELETE/plants/{id}RequiredDelete a plant listing
GET/plants/searchOptionalSearch plants by name or category
GET/categoriesOptionalList all plant categories
POST/categoriesRequiredCreate a new category
GET/ordersRequiredList orders for the current user
POST/ordersRequiredPlace a new order
GET/orders/{id}RequiredGet order details
DELETE/orders/{id}RequiredCancel an order
GET/users/meRequiredGet the current user profile
PATCH/users/meRequiredUpdate the current user profile
POST/auth/tokenNoneExchange credentials for a token
1–5 of 15

everyone

This repository is a starter template for building documentation with Fern. It includes a sample Plant Store API to demonstrate how Fern generates interactive API reference documentation from an OpenAPI specification.

Use this template to get started quickly, then replace the sample content with your own API and documentation.

What’s included

This starter template contains everything you need to publish documentation:

docs.yml# Configures navigation, theme, and hosting
fern.config.json# Sets your organization name and CLI version
openapi.yaml# Sample Plant Store API specification
docs
pages# Markdown content for your documentation
assets# Logos, favicon, and other assets

Getting started

1

Clone this repository

git clone <your-template-repo.git>
cd docs-starter
2

Install the Fern CLI

npm install -g fern-api
3

Preview locally

Start a local development server with hot-reloading:

fern docs dev

Open http://localhost:3000 to see your docs.

4

Make it yours

Update fern.config.json with your organization name and docs.yml with your desired URL:

fern.config.json
{
"organization": "your-org-name",
"version": "0.46.15"
}
docs.yml
instances:
- url: your-org.docs.buildwithfern.com
5

Publish

When you’re ready to go live:

fern generate --docs

Next steps

Replace the sample Plant Store API with your own OpenAPI specification, update the Markdown pages with your content, and customize the theme to match your brand. For detailed guidance, explore the pages in this documentation or visit the Fern documentation.

Edit your docs

Learn how to preview and publish changes using the CLI or Fern Editor

Set up navigation

Configure tabs, sections, and pages in your docs.yml file

Customize your docs

Brand your documentation with colors, logos, and layouts

API reference

See how Fern generates interactive API documentation