Skip to content
Scrollback
Go back
How-To

Customising Scrollback

Nearly everything you will want to change lives in astro-paper.config.ts at the root of the project.

Site details

Set your title, description, author and the URL the site will be deployed to. The home page heading and intro text have their own home section.

Topic cards

topics: {
  source: "category",   // or "tags"
  minPosts: 1,          // hide topics with fewer posts than this
  maxVisible: 6,        // cards shown before "Show more topics"
  exclude: ["others"],  // slugs to leave out
  overrides: {
    "t-sql": { label: "T-SQL", description: "Scripts for SQL Server" },
  },
}

Labels are generated automatically, so home-lab becomes “Home Lab”. Use overrides when the auto-generated label is wrong, or to add a short description to a card.

Badge colours

postTypes: {
  "How-To": "blue",
  "Deep Dive": "orange",
  Note: "teal",
  Opinion: "purple",
}

The available colours are blue, orange, teal, purple and gray. A type that isn’t listed gets a grey badge.

Colours and fonts

The colour scheme is in src/styles/theme.css. Change the CSS variables there for light and dark mode separately.


Share this post:

Previous Post
How topics, categories and tags fit together
Next Post
A short note