Skip to content

odhyp/astro-sidey

Repository files navigation

Astro Sidey

A content-focused, side-anchored minimalist theme designed for developers, writers, and digital gardeners. Built on Astro. Nothing in the way, just your words on a clean, fast canvas.

Live Demo · Getting Started


Features

  • Minimal by design — few files, little styling, easy to modify
  • Typography first — set in Geist with a clean, readable prose layout
  • Flexoki color scheme — a warm, paper-like palette for comfortable reading in light/dark mode
  • Expressive Code — syntax highlighting with line numbers and collapsible sections
  • Image lightbox — click any image to open it full screen
  • Auto-generated routes — folder structure maps directly to URLs
  • Single config file — everything lives in sidey.config.ts
  • View Transitions — smooth client-side navigation
  • RSS Feed & Sitemap — generated automatically from your content
  • MDX support — use components inside your markdown

Quick Start

Click Use this template on GitHub to create a new repository, then:

git clone https://github.com/your-username/your-repo.git
cd your-repo
npm install
npm run dev

Open sidey.config.ts and fill in your details. That is the whole setup.

Content Structure

File URL
src/content/pages/home.mdx /
src/content/pages/about.mdx /about
src/content/writings/my-post.mdx /writings/my-post

Read more about content structure at sidey.odhyp.com/writings/2-content-structure.

Built With

License

MIT License. See LICENSE for details.