Skip to content

nice/clarity

Repository files navigation

Clarity: Minimal blog theme for Astro!

Demo: https://clarity-astro-theme.netlify.app/

screenshot-clarity-astro-theme netlify app-2024 03 05-19_13_15

Features

  • ✅ Masonry layout (lightweight version)
  • ✅ 3 card types (default, text only, image only)
  • ✅ 3 card sizes (small, medium, large)
  • ✅ Customizable accent colors (see configuration)
  • ✅ Image fade in animation (with. noscript fallback)
  • ✅ Good Lighthouse performance
  • ✅ SEO-friendly
  • ✅ Sitemap support
  • ✅ RSS Feed support
  • ✅ Markdown & MDX support
  • ✅ View transitions support (see configuration)

Lighthouse performance

Screenshot from 2024-03-05 19-12-54

Usage

1. Clone this repo.

git clone [email protected]:nice/clarity.git

2. Switch to the cloned folder

cd clarity/

3. Install dependencies

npm install

4. Starting development server

npm run dev

Building for production

npm run build

Configuration

Theme configuration can be found inside src/consts.ts

!!! Important !!! Please make sure to update the default email ids, site title and descriptions.

You can also change the theme accent colors, menu items and posts per page from the src/consts.ts file.

View transitions

Enable view transitions for Clarity theme with the below few steps

  1. Import ViewTransitions in src/layouts/Layout.astro
---
import { ViewTransitions } from 'astro:transitions';
---
  1. Add the <ViewTransitions /> tag inside <head> of the same file
<head>
  <ViewTransitions />
</head>
  1. Add transition:animate attribute to opening <html> tag in the same file.
<html transition:animate="fade">
</html>
  1. Add the below Clarity theme specific script just before the closing </html> tag in the same file.

<!-- other scripts -->

<script>
  document.addEventListener("astro:after-swap", initGrid);
  document.addEventListener("astro:after-swap", initAppear);
  document.addEventListener("astro:after-swap", initMenu);
</script>

About

Minimal blog theme for Astro!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published