Working Notes

Start here — making this blog yours

The handful of files to change before the first real post, in the order worth changing them.

· 1 min read

Everything on this site comes from a few files, and most of what makes it look like someone’s blog lives in four of them. Change these first.

1. The name and the one-liner

src/consts.ts holds the blog’s title and description. The header, every page’s <title>, the RSS feed and the home page all read from it, so it is one edit:

export const SITE_TITLE = 'Working Notes';
export const SITE_DESCRIPTION =
  'A blog started from a template. Swap this line for what you write about.';

2. The accent colour

Links, tags, focus rings and the button all come from a single variable at the top of src/styles/global.css. Dark mode lightens it on its own, so you only pick one colour:

:root {
  --accent: #0f766e;
}

3. The home page intro and the about page

The intro on the home page — the part that says Astro blog template — is the template advertising itself. Cut src/pages/index.astro down to the heading and the description, or delete the section. Then rewrite src/pages/about.astro.

Delete these three sample posts too, once you have read them. They are plain files in src/content/posts/; nothing else refers to them.

4. The address

The canonical links, the feed and the sitemap need the blog’s real address. The deploy workflow already fills it in from your site name, so a blog served at https://myblog.one9x.app needs nothing.

Once you link your own domain, add a repository variable named SITE_URL (Settings → Secrets and variables → Actions → Variables) with the full address, for example https://blog.example.com. The next deploy uses it everywhere.

The footer ends with Deployed on One9x Pages. It is one line in src/layouts/Base.astro, marked with a comment, and nothing depends on it — delete it if you would rather not have it.