Skip to main content

Configuration

Nocturne ships pre-configured. But you'll want to make it yours.

This section covers every configuration file in Nocturne:

FileWhat It Controls
docusaurus.config.tsSite title, URL, theme, plugins
sidebars.tsSidebar structure
static/admin/config.ymlDecap CMS admin panel
src/data/*.jsonHomepage, navbar, widgets, site info

Edit these files directly in a text editor. Or use Decap CMS for the JSON data files.

What You Need to Know​

Before you start configuring Nocturne, understand this:

TypeScript Files​

docusaurus.config.ts and sidebars.ts are TypeScript files. You edit them in a text editor, then run npm start to see the changes.

JSON Files​

src/data/*.json are JSON files. You can edit them in a text editor — or through Decap CMS at /admin/.

YAML File​

static/admin/config.yml is a YAML file for Decap CMS. Edit it in a text editor.

Configuration Order​

If you're configuring Nocturne for the first time, follow this order:

  1. docusaurus.config.ts — set your site title, URL, and metadata
  2. src/data/site.json — set your product identity
  3. src/data/navbar.json — set navigation links
  4. src/data/home.json — set homepage content
  5. src/data/widgets.json — set sidebar widgets
  6. sidebars.ts — structure your documentation
  7. static/admin/config.yml — set up Decap CMS

What You Can Configure​

SectionFilePurpose
Docusaurus Configdocusaurus.config.tsSite identity, theme, plugins
Sidebar Configsidebars.tsDocumentation structure
Decap CMSstatic/admin/config.ymlAdmin panel configuration
Data Filessrc/data/*.jsonHomepage, navbar, widgets

What's Next?​

Start with the most important config file — Docusaurus.

👉 Next: Docusaurus Config →