https://github.com/fjelloverflow/nordlys

A minimal Astro blog theme
https://github.com/fjelloverflow/nordlys

astro astro-template astro-theme blog ssg tailwindcss template theme

Last synced: about 2 months ago
JSON representation

A minimal Astro blog theme

• Host: GitHub
• URL: https://github.com/fjelloverflow/nordlys
• Owner: FjellOverflow
• License: gpl-3.0
• Created: 2024-09-25T13:16:26.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-04-09T18:42:55.000Z (2 months ago)
• Last Synced: 2026-04-09T20:26:14.435Z (2 months ago)
• Topics: astro, astro-template, astro-theme, blog, ssg, tailwindcss, template, theme
• Language: Astro
• Homepage: https://nordlys.fjelloverflow.dev/
• Size: 16.1 MB
• Stars: 62
• Watchers: 2
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Security: .github/SECURITY.md

Awesome Lists containing this project

README

          


  Nordlys





  A minimal Astro blog theme





  

    

  





  

   

  

   

  





  Preview |

  Features |

  Installation |

  Getting started |

  Documentation



## Features



  

    

  

  
Nordlys scores 100% on Lighthouse





- ⚙️ Easily configurable

- 🖼️ Photo galleries

- 🔎 Built-in Search

- 📱 Resonsive & mobile friendly

- 🧑‍🦯 Accessible

- 🎨 Built-in & custom color schemes

- 🌙 Light & Dark mode

- 🎁 Image zoom, generated _Table of Contents_, reading time & more ...

- 👨‍💻 **For developers**:

  - Best practices

  - Minimal & up-to-date dependencies

  - Strongly typed & linted

## Installation

0. Make sure you have [pnpm](https://pnpm.io/installation) installed on your system.

1. - Clone or [fork](https://github.com/new?template_name=nordlys&template_owner=FjellOverflow) this repository or

   - Create a new project with `pnpm dlx create-astro --template FjellOverflow/nordlys`.

2. Run `pnpm install`.

3. Run `pnpm dev`.

4. (To install the recommended extensions for VSCode, open the _Extensions_ tab and type `@recommended`.)

## Getting started

The look and feel of the theme are configured in `theme.config.ts`. Make sure to adjust the title, author, URL, and color scheme to your preferences. Defaults are provided for most settings.

All content is written in Markdown or MDX. Adding new pages, blog posts, or projects is as simple as creating a `my-latest-post.md` file in the appropriate directory and adjusting the frontmatter. For specific properties that can or need to be set, refer to the provided examples.

## Documentation

The theme is self-documenting. Just head over to [nordlys.fjelloverflow.dev](https://nordlys.fjelloverflow.dev/posts/) for examples and tutorials on how to use and customize the theme.