Astro Theme Pure

Code for The Data Quarry blog site, built with Astro & TypeScript. This site is built on top of the Pure theme for Astro.

Introduction

Checkout the site →.

Why Astro and the Pure theme?

• Fast & high performance
• Simple & clean design
• Responsive design
• Full-site search built with pagefind
• Sitemap & RSS feed
• SEO-friendly
• TOC (table of contents)
• Dynamic open graph generation for posts
• Mediumzoom lightbox for images
• Easy-to-customize components
• Footnotes
• Readymade KaTeX support for mathematical symbols and equations
• Aside boxes for emphasizing key points
• Easy to add YouTube and X (Twitter) embeds

Local development

Environment used:

• Nodejs: 20.0.0+

Clone the source repository and customize to your liking:

git clone https://github.com/cworld1/astro-theme-pure.git
cd astro-theme-pure

Useful commands:

# install dependencies
bun install

# start the dev server
bun dev

# build the project
bun run build

# preview (after the build)
bun preview

# create a new post
bun new-post

Deployment

A GitHub Actions workflow is configured to deploy the site via GitHub Pages. The pipeline is triggered when a commit is pushed to the main branch.

Adding New Posts

Add MDX files to a custom directory in src/content/blog.

Note

MDX combines JSX and Markdown to make it easier to write component-driven content like tabbed code blocks. This theme requires that you work with .mdx files instead of .md when using JSX components. See the official MDX documentation for more information.

👀 Learn more

See the official Astro docs and the Pure theme repo to learn more how to customize the site. Many thanks to the maintainers of both these projects. 🫶🏼

License

The Astro project is MIT licensed and the Pure theme has an Apache 2.0 license.