Dev Notes

Env

This project uses Nix Flake for environment and toolkit management.

The Nixpkgs version is currently 26.05, the core packages include:

• NodeJS 24.16.0
• Typescript 5.9.3

Recommended language servers:

• typescript-language-server 5.3.0
• astro-language-server 2.16.7
• tailwindcss-language-server 0.14.29
• nil 2025-06-13

After installing Nix, you may enter specific environments with the following commands:

• nix develop .#core: all core packages.
• nix develop .#nvim: core + automatically configure all recommended language servers.

Direnv: TODO

Font

Sydney Train uses the New Frank premium font which requires an A*obe subscription. Claude Sonnet found me this Libre Franklin on Google Fonts which seems to be free for use.

Neovim

Tree-sitter setup:

:TSInstall astro typescript tsx javascript css html

References

• https://transportnsw.info/sydney-trains-network-map
• https://transportnsw.info/sydney-ferries-network-map
• https://transportnsw.info/regional-network-map
• https://transportnsw.info/sydney-lightrail-network-map
• https://transportnsw.info/intercity-trains-network-map

Misc

Click here for AI slop

Astro Starter Kit: Blog

npm create astro@latest -- --template blog

🧑‍🚀 Seasoned astronaut? Delete this file. Have fun!

Features:

• ✅ Minimal styling (make it your own!)
• ✅ 100/100 Lighthouse performance
• ✅ SEO-friendly with canonical URLs and Open Graph data
• ✅ Sitemap support
• ✅ RSS Feed support
• ✅ Markdown & MDX support

🚀 Project Structure

Inside of your Astro project, you'll see the following folders and files:

├── public/
├── src/
│   ├── assets/
│   ├── components/
│   ├── content/
│   ├── layouts/
│   └── pages/
├── astro.config.mjs
├── README.md
├── package.json
└── tsconfig.json

Astro looks for .astro or .md files in the src/pages/ directory. Each page is exposed as a route based on its file name.

There's nothing special about src/components/, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.

The src/content/ directory contains "collections" of related Markdown and MDX documents. Use getCollection() to retrieve posts from src/content/blog/, and type-check your frontmatter using an optional schema. See Astro's Content Collections docs to learn more.

Any static assets, like images, can be placed in the public/ directory.

🧞 Commands

All commands are run from the root of the project, from a terminal:

Command	Action
npm install	Installs dependencies
npm run dev	Starts local dev server at localhost:4321
npm run build	Build your production site to ./dist/
npm run preview	Preview your build locally, before deploying
npm run astro ...	Run CLI commands like astro add, astro check
npm run astro -- --help	Get help using the Astro CLI

👀 Want to learn more?

Check out our documentation or jump into our Discord server.

Credit

This theme is based off of the lovely Bear Blog.