Configuration · Silica Docs

All of your site's settings live in silica.config.ts at the project root.

TypeScript

import { defineConfig } from "@silicajs/core";

export default defineConfig({
  title: "My Site",
  description: "Site description",
  baseUrl: "https://docs.example.com",
  theme: "default",
});

Site basics

Option	Default	What it does
`title`	`"Silica"`	Site name in the header, metadata, and search
`description`	`"A Silica knowledge site"`	Default page description
`logo`	—	Logo on the sign-in page (`/logo.svg` or a URL)
`baseUrl`	—	Your public URL, used for the sitemap and sign-in
`contentDir`	`"content"`	Folder that holds your Markdown vault
`theme`	`"default"`	The site theme

Links

Option	Default	What it does
`wikilinks.strategy`	`"shortest"`	`"shortest"`, `"absolute"`, or `"relative"`
`wikilinks.strict`	`false`	Fail the build when links cannot resolve

See Links.

Option	Default	What it does
`tags.inline`	`true`	Recognize `#tags` written in note bodies

Ordering

Option	Default	What it does
`ordering.numericPrefixes`	`true`	Use leading numbers for ordering only

When on, files like 01_Home.md sort by their number while the number is dropped from URLs and labels. See Navigation.

Which pages get published

Option	Default	What it does
`filters.removeDrafts`	`true`	Exclude pages with `draft: true`
`filters.explicitPublish`	`false`	Require `publish: true` to include a page

See Drafts and publishing.

Authentication

Leave it off (the default) for a public site, or configure it:

TypeScript

auth: {
  provider: "google",
  allowedDomains: ["example.com"],
  allowedEmails: ["you@example.com"],
}

See Authentication.

Editing the config

Changing silica.config.ts restarts the dev server. Content-only edits reload instantly.

Search