jekyll-theme-nyx 0.2.3 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fd2a4bae7307d93a46dbb19bffc3887b4bc4e976ce6b6a172bb9d362caeb907
-  data.tar.gz: 6ce8ba0a16ba6fd04e9fed93481c48583b9b3436294f78813a08a4d8f307ff4b
+  metadata.gz: 4255ca5efed8bc6aa4c303c219117c7cd062ef2c8dc409068bdb67cb02eb7a31
+  data.tar.gz: 8db90df707ef2c6bfc92fb42eb477f869be8528534a43a602af04d6779933b9e
 SHA512:
-  metadata.gz: ce178c4e9fc5bf0c58502f5da26565f87775786fac39f1ba6183728b074171dff441104f9eb86ae986e91a58a23b5fcd889087396d4303d0f3ee6cded6e115b0
-  data.tar.gz: b45496031b331995a53765d17b6421653471f4d0489e3ad1ab752eae36bdeb8443db9028faa9ef12f7ec7bb8f33112edc6864776b80b36e5a3eeaf335fde7a5d
+  metadata.gz: 042614cbceeeb38aeb930e4e58761fb93589b51ebfa8f573697d3fe268e255680e8c5d84ac8392ec4b2468acff3d5df2b71112cc66b1e3380c52fbede7362e33
+  data.tar.gz: fb55859fee5bbe19c7fbd7f085b2e8c9e7f9782bc3eb4645206fcba179837f74af3d0e0ad743877f0e5fb89df40c78497fcd184839e23ef56cbfc55edfb203f1

data/.github/CONTRIBUTING.MD

@@ -0,0 +1,107 @@
+# Contributing to Nyx
+
+First of all, thanks for contributing!
+
+## How to Contribute (High Level)
+
+1. **Identify a problem or improvement**
+2. **Open or claim an issue**
+3. **Fork the repo**
+4. **Create a branch**
+5. **Make your changes**
+6. **Open a pull request**
+
+If you do not open or claim an issue, your pull request will likely be rejected.
+
+---
+
+## Issues Come First
+
+Before you open a PR, **there should be an issue**.
+
+This applies if you are:
+- Fixing a bug
+- Adding a feature
+- Refactoring existing behavior
+- Changing styling, layout, or structure in a non-trivial way
+
+### Why?
+- It prevents duplicate work
+- It lets us agree on direction before code is written
+- It gives context to your PR
+- It creates a paper trail for future contributors
+
+### What to do:
+- If an issue already exists comment on it and say you’re working on it
+- If no issue exists open one
+- If you’re unsure open an issue anyway and ask
+
+> Small things like typo fixes can skip the issue step. Use your judgment.
+
+---
+
+## Fork & Branch
+
+1. Fork the repository
+2. Clone your fork locally
+3. Create a branch from `main`
+
+```bash
+git checkout -b fix/my-short-description
+```
+
+Please use clear branch names.
+
+## Making Changes
+
+A few expectations:
+
+- Follow the existing code style
+- Don’t reformat unrelated files
+- Keep commits focused and meaningful
+- If you change behavior, explain why in the commit or PR
+
+If your change affects:
+- layout
+- tags/categories
+- syntax highlighting
+- build behavior
+
+…please call that out clearly in your PR description.
+## Testing
+
+Before opening a PR:
+
+- Run the site locally with `bundle exec jekyll serve`
+- Click around
+- Check mobile widths
+- Verify tags, categories, and posts still render correctly
+
+## Opening a Pull Request
+
+When opening your PR:
+
+- Reference the issue it fixes (e.g. Fixes #12)
+- Explain what you changed
+- Explain why you changed it
+- Include screenshots if it’s visual
+- Keep it scoped — one PR, one purpose
+
+Please fill out the PR template when opening a pull request. That helps us with understanding what your PR is trying to do. PRs without context or without an associated issue may be closed or sent back for clarification.
+
+# Philosophy
+
+Nyx aims to be:
+
+- Minimal
+- Understandable
+- Hackable without too many plugins
+- Predictable in structure
+
+If your contribution makes things more magical but harder to reason about, it probably doesn’t fit. If you’re unsure, open an issue and ask.
+
+---
+
+Thanks again for contributing 💜
+
+---

data/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,47 @@
+name: Bug Report
+description: Create a report to help us improve
+labels:
+  - bug
+body:
+  - type: textarea
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps To Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. In this environment...
+        2. With this config...
+        3. Run '...'
+        4. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected Behavior
+      description: A concise description of what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Environment
+      value: |
+        - Ruby: <!-- run `ruby -v` -->
+        - Jekyll: <!-- run `bundle exec jekyll -v` -->
+        - Nyx: <!-- run `bundle info jekyll-theme-nyx` -->
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Anything else?
+      description: |
+        Add any extra context here.
+        Logs, screenshots, or weird edge cases welcome.

data/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

data/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,28 @@
+name: Feature Request
+description: Suggest an idea for this project
+labels:
+  - enhancement
+body:
+  - type: textarea
+    attributes:
+      label: Is your feature request related to a problem? Please describe
+      description: A clear and concise description of what the problem is.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+
+  - type: textarea
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.

data/.github/pull_request_template.md

@@ -0,0 +1,31 @@
+## jekyll-theme-nyx Pull Request
+
+Thanks for contributing. Fill this out so future-you doesn't hate past-you.
+
+## What does this PR do?
+<!-- Short, clear explanation of the change. -->
+
+
+## Link to the relevant issue
+<!-- All changes must be discussed in an issue first. Failure to do so may result in your Pull Request being rejected -->
+fixes #<!--issue ID here-->
+
+## List the main changes.
+<!-- For example: "Added new tab layout", "Fixed Rouge highlighting", "Cleaned up SCSS variables" -->
+
+
+## Type of Change
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Refactor / Cleanup
+- [ ] Docs only
+
+## Checklist
+
+- [ ] Code builds without errors (`rake site`)
+- [ ] Tested locally with Jekyll
+- [ ] No unnecessary files committed
+
+## Additional Notes
+<!-- Anything reviewers should know? Edge cases, follow-ups, known issues. -->

data/CHANGELOG.md

@@ -1,14 +1,16 @@
-## [0.1.0] - 2026-01-01
+# CHANGELOG
+
+### [0.1.0] - 2026-01-01
 
 - Initial release
 
-## [0.1.1] - 2026-01-02
+#### [0.1.1] - 2026-01-02
 
 - Added Rakefile for consistent functionality with pushing finished work
 
 - Added GitHub Action to deploy site to GitHub Pages
 
-## [0.2.0] - 2026-01-03
+### [0.2.0] - 2026-01-03
 
 - Added Layouts:
   - Default
@@ -18,6 +20,41 @@
   - Layouts
   - Syntax Highlighting
 
-## [0.2.1] - 2026-01-04
+#### [0.2.1] - 2026-01-04
+
+- Fixed Syntax Highlighting
+
+#### [0.2.2] - 2026-01-05
+
+- Updated the following to be more aligned with the goals of this project:
+  - README
+  - Gemfile
+  - Gemfile.lock
+  - Gemspec
+  - Rakefile
+  - _config.yml
+
+- Added cert signing for verification and security
+
+#### [0.2.3] - 2026-01-05 
+
+- Update header style
+- Fixed bug causing line breaks to appear as dots
+- Added lorem ipsum to the demo post
+
+### [0.3.0] - 2026-01-06
+
+- Added issue templates
+- Added the following pages:
+  - /posts/
+  - /tags/
+  - /categories/
+  - /about/
 
-- Fixed Syntax Highlighting
+#### [0.3.1] - 2026-01-06
+- Added Pull Request Templates
+- Moved the Issue templates to `yml`
+- Create plugin to generate subpages for tags and categories
+  - added styling for tag and category tabs
+- Added Contribution guide
+- Added Security policy

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in jekyll-theme-nyx.gemspec
-gemspec
+gemspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    jekyll-theme-nyx (0.2.3)
+    jekyll-theme-nyx (0.3.1)
       jekyll (~> 4.0)
 
 GEM

data/Rakefile

@@ -1,46 +1,46 @@
 # frozen_string_literal: true
 
-require "rake"
-require "fileutils"
+require 'rake'
+require 'fileutils'
 
-GEMSPEC = "jekyll-theme-nyx.gemspec"
+GEMSPEC = 'jekyll-theme-nyx.gemspec'
 
 # Helper to get current version from gemspec
 def current_version
   File.read(GEMSPEC)[/spec\.version\s*=\s*["'](.*?)["']/, 1]
 end
 
-GEM_NAME = GEMSPEC.sub(/\.gemspec$/, "")
-GEM_FILE = "#{GEM_NAME}-#{current_version}.gem"
+GEM_NAME = GEMSPEC.sub(/\.gemspec$/, '')
+GEM_FILE = "#{GEM_NAME}-#{current_version}.gem".freeze
 
-desc "Build dummy site to verify theme"
+desc 'Build dummy site to verify theme'
 task :site do
-  sh "bundle install"
-  sh "bundle exec jekyll build"
-  puts "[+] Dummy site builds successfully"
+  sh 'bundle install'
+  sh 'bundle exec jekyll build'
+  puts '[+] Dummy site builds successfully'
 end
 
-desc "Build the gem"
+desc 'Build the gem'
 task :build do
   sh "gem build #{GEMSPEC}"
   puts "[+] Built #{GEM_FILE}"
 end
 
-desc "Push gem to RubyGems"
+desc 'Push gem to RubyGems'
 task :push do
   sh "gem push #{GEM_FILE}"
 end
 
-desc "Create and push git tag"
+desc 'Create and push git tag'
 task :tag do
   sh "git tag v#{current_version}"
   sh "git push origin v#{current_version}"
 end
 
-desc "Full release: site build, gem build, push, tag"
+desc 'Full release: site build, gem build, push, tag'
 task release: [:site] do
-  sh "rake build"
-  sh "rake push"
-  sh "rake tag"
+  sh 'rake build'
+  sh 'rake push'
+  sh 'rake tag'
   puts "[+] Released #{GEM_NAME} v#{current_version}"
 end

data/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Supported Versions
+
+<!--| Version | Supported          |
+| ------- | ------------------ |
+| 5.1.x   | :white_check_mark: |
+| 5.0.x   | :x:                |
+| 4.0.x   | :white_check_mark: |
+| < 4.0   | :x:                |-->
+
+The most recent major release is supported.
+
+## Reporting a Vulnerability
+
+If you find a vulnerability, please email me at me@slavetomints.com. You can expect to receive a response within a week. If your vulnerability is accepted you will be credited on the demo site after it has been patched.

data/_config.yml

@@ -2,8 +2,6 @@ title: Nyx Demo
 theme: jekyll-theme-nyx
 
 markdown: kramdown
-
-
 kramdown:
   syntax_highlighter: rouge
   syntax_highlighter_opts:
@@ -11,7 +9,6 @@ kramdown:
     block:
       line_numbers: true
 
-
 exclude:
   - "*.gem"
   - "*.gemspec"
@@ -20,4 +17,10 @@ exclude:
   - Rakefile
   - CHANGELOG.md
   - CODE_OF_CONDUCT.md
-  - "certs/slavetomints.pem"
+  - "certs/slavetomints.pem"
+
+collections:
+  tabs:
+    output: true
+    permalink: /:name/
+    sort_by: order

data/_includes/header.html

@@ -0,0 +1,11 @@
+<header>
+  {% assign tabs = site.tabs | sort: "nav_order" %}
+  <ul>
+    <li><a href="/">Home</a></li>
+    {% for tab in tabs %}
+      <li><a href="{{ tab.url | relative_url }}" class="{% if page.url == tab.url %}active{% endif %}">
+          {{ tab.title }}
+      </a></li>
+    {% endfor %}
+  </ul>
+</header>

data/_layouts/category.html

@@ -0,0 +1,19 @@
+---
+layout: default
+---
+
+<h1>Category: {{ page.category }}</h1>
+
+<ul class="post-list">
+  {% for post in page.posts %}
+    <li class="post-item">
+      <h2>
+        <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+      </h2>
+      <time>{{ post.date | date: "%B %d, %Y" }}</time>
+      {% if post.description %}
+        <p>{{ post.description | strip_html }}</p>
+      {% endif %}
+    </li>
+  {% endfor %}
+</ul>

data/_layouts/default.html

@@ -1,13 +1,30 @@
 <!DOCTYPE html>
 <html lang="en">
+
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <link rel="stylesheet" href="{{ "/assets/css/nyx.css" | relative_url }}">
   <title>{{ site.title }}</title>
 </head>
+
 <body>
-  {% include sidebar.html %}
-  {{ content }}
+  {% include header.html %}
+  <main>
+    {{ content }}
+  </main>
 </body>
+
+<script>
+document.addEventListener("DOMContentLoaded", () => {
+  document.querySelectorAll('div.highlighter-rouge').forEach(wrapper => {
+    const parent = wrapper.parentNode;
+    const inner = wrapper.querySelector('.highlight');
+    if (inner && parent) {
+      parent.replaceChild(inner, wrapper);
+    }
+  });
+});
+</script>
+
 </html>

data/_layouts/post.md

@@ -5,18 +5,5 @@ layout: default
   <h1>{{ page.title }}</h1>
   <p>{{ page.date | date: "%B %d, %Y" }} – Written by {{ page.author }}</p>
 </header>
-<main>
-  {{ content }}
-</main>
+{{ content }}
 
-<script>
-document.addEventListener("DOMContentLoaded", () => {
-  document.querySelectorAll('div.highlighter-rouge').forEach(wrapper => {
-    const parent = wrapper.parentNode;
-    const inner = wrapper.querySelector('.highlight');
-    if (inner && parent) {
-      parent.replaceChild(inner, wrapper);
-    }
-  });
-});
-</script>

data/_layouts/tag.html

@@ -0,0 +1,19 @@
+---
+layout: default
+---
+
+<h1>Tag: {{ page.tag }}</h1>
+
+<ul class="post-list">
+  {% for post in page.posts %}
+    <li class="post-item">
+      <h2>
+        <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+      </h2>
+      <time>{{ post.date | date: "%B %d, %Y" }}</time>
+      {% if post.description %}
+        <p>{{ post.description | strip_html }}</p>
+      {% endif %}
+    </li>
+  {% endfor %}
+</ul>

data/_plugins/taxonomy_pages.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Jekyll
+  class TaxonomyPages < Generator
+    safe true
+
+    def generate(site)
+      site.tags.each do |tag, posts|
+        site.pages << TaxonomyPage.new(
+          site,
+          site.source,
+          File.join('tags', tag.downcase.gsub(' ', '-')),
+          'tag.html',
+          tag,
+          posts
+        )
+      end
+
+      site.categories.each do |category, posts|
+        site.pages << TaxonomyPage.new(
+          site,
+          site.source,
+          File.join('categories', category.downcase.gsub(' ', '-')),
+          'category.html',
+          category,
+          posts
+        )
+      end
+    end
+  end
+
+  class TaxonomyPage < Page
+    def initialize(site, base, dir, layout, name, posts)
+      @site = site
+      @base = base
+      @dir  = dir
+      @name = 'index.html'
+
+      process(@name)
+      read_yaml(File.join(base, '_layouts'), layout)
+
+      data['posts'] = posts
+      data[layout.sub('.html', '')] = name
+      data['title'] = name
+    end
+  end
+end

data/_sass/nyx/_base.scss

@@ -27,6 +27,22 @@ a:hover {
   text-decoration: underline;
 }
 
+header a {
+  color: $muted;
+}
+
+header a:hover {
+  text-decoration: none;
+  color: $fg
+}
+
+header ul{
+  display: flex;
+  flex-direction: row;
+  justify-content: space-around;
+  list-style-type: none;
+}
+
 img {
   max-width: 100%;
   height: auto;
@@ -35,6 +51,6 @@ img {
 
 hr {
   border: none;
-  border-top: 2px solid #f8f8f2;
+  border-top: 2px solid $fg;
   margin: 1.5rem 0;
 }

data/_sass/nyx/_layout.scss

@@ -1,12 +1,5 @@
 @use "variables" as *;
 
-#sidebar-list {
-  display: flex;
-  flex-direction: row;
-  justify-content: space-around;
-  list-style-type: none;
-}
-
 header,
 footer {
   padding: $space-2 $space-3;
@@ -15,6 +8,118 @@ footer {
 main {
   display: flex;
   flex-direction: column;
-  padding: $space-4;
+  padding: $space-4 25vw;
   min-width: 0;
+
+  @media (max-width: 600px) {
+    padding: $space-4;
+  }
+}
+
+/* STYLING FOR /POSTS/ */
+
+.post-list {
+  list-style: none;
+  padding: 0;
+  margin: 2rem 0;
+
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 1.5rem;
+}
+
+.post-item {
+  background: $card-bg;
+  border: 1px solid rgba(255, 255, 255, 0.06);
+  border-radius: 0.75rem;
+  padding: 1.5rem;
+
+  transition: transform 0.15s ease, box-shadow 0.15s ease;
+}
+
+.post-item:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);
+  text-decoration: none;
+  position: relative;
+}
+
+.post-item h2 {
+  margin: 0 0 0.25rem 0;
+  font-size: 1.4rem;
+}
+
+.post-item h2 a {
+  text-decoration: none;
+  color: inherit;
+}
+
+.post-item h2 a:hover {
+  text-decoration: underline;
+}
+
+.post-item h2 a::after {
+  content: "";
+  position: absolute;
+  inset: 0;
+}
+
+.post-item time {
+  display: block;
+  font-size: 0.85rem;
+  color: $muted;
+  margin-bottom: 0.75rem;
+}
+
+.post-item p {
+  margin: 0;
+  color: $fg;
+  line-height: 1.6;
+}
+
+/* taxonomy lists (tags + categories) */
+
+.taxonomy-list {
+  list-style: none;
+  padding: 0;
+  margin: $space-4 0;
+
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(14rem, 1fr));
+  gap: $space-3;
+}
+
+.taxonomy-item {
+  background: $bg-alt;
+  border: 1px solid rgba(255, 255, 255, 0.06);
+  border-radius: $radius;
+  transition: transform 0.15s ease, box-shadow 0.15s ease;
+}
+
+.taxonomy-item a {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+
+  padding: $space-3;
+  text-decoration: none;
+  color: $fg;
+}
+
+.taxonomy-item:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);
+}
+
+.taxonomy-name {
+  font-size: 1rem;
+  font-weight: 600;
+}
+
+.taxonomy-count {
+  font-size: 0.85rem;
+  color: $muted;
+  background: rgba(255, 255, 255, 0.06);
+  padding: 0.15rem 0.5rem;
+  border-radius: 999px;
 }

data/_sass/nyx/_variables.scss

@@ -19,3 +19,8 @@ $space-5: 4rem;
 /* Layout */
 $max-width: 72ch;
 $radius: 6px;
+
+/* Cards */
+$card-bg: #0f111a;
+$card-border: rgba(255, 255, 255, 0.06);
+$card-shadow-hover: 0 8px 24px rgba(0, 0, 0, 0.35);

data/_tabs/about.md

@@ -0,0 +1,9 @@
+---
+layout: default
+permalink: /about/
+order: 4
+---
+
+<h1>About</h1>
+
+This is your "about me" page, where you can add anything about yourself that you wish for the world to know. It uses the default layout rather than the post layout. Feel free to drop your work experience, resume, or just a little blurb about who you are and who you're trying to become.

data/_tabs/categories.md

@@ -0,0 +1,19 @@
+---
+layout: default
+permalink: /categories/
+order: 2
+---
+
+<h1>Categories</h1>
+
+<ul class="taxonomy-list categories-list">
+  {% for category in site.categories %}
+    {% assign name = category[0] %}
+    <li class="taxonomy-item">
+      <a href="{{ '/categories/' | append: name | downcase | append: '/' | relative_url }}">
+        <span class="taxonomy-name">{{ name }}</span>
+        <span class="taxonomy-count">{{ category[1].size }}</span>
+      </a>
+    </li>
+  {% endfor %}
+</ul>

data/_tabs/posts.md

@@ -0,0 +1,24 @@
+---
+layout: default
+permalink: /posts/
+order: 1
+---
+
+# Posts
+
+<ul class="post-list">
+  {% for post in site.posts %}
+    <li class="post-item">
+      <h2>
+        <a href="{{ post.url | relative_url }}">{{ post.title }}</a>
+      </h2>
+      <time datetime="{{ post.date | date_to_xmlschema }}">
+        {{ post.author }} - {{ post.date | date: "%B %d, %Y" }}
+      </time>
+      {% if post.description %}
+        <p>{{ post.description | strip_html }}</p>
+      {% endif %}
+    </li>
+  {% endfor %}
+</ul>
+

data/_tabs/tags.md

@@ -0,0 +1,19 @@
+---
+layout: default
+permalink: /tags/
+order: 3
+---
+
+<h1>Tags</h1>
+
+<ul class="taxonomy-list tags-list">
+  {% for tag in site.tags %}
+    {% assign name = tag[0] %}
+    <li class="taxonomy-item">
+      <a href="{{ '/tags/' | append: name | append: '/' | relative_url }}">
+        <span class="taxonomy-name">{{ name }}</span>
+        <span class="taxonomy-count">{{ tag[1].size }}</span>
+      </a>
+    </li>
+  {% endfor %}
+</ul>

data/index.md

@@ -3,8 +3,110 @@ layout: default
 title: Home
 ---
 
-# Hello Nyx!
+# jekyll-theme-nyx
 
-This is a live demo of Nyx, a simple Jekyll theme.
+Nyx is a dark mode based Jekyll theme focused on readability, clean typography, and simple blogging. It is designed to work out-of-the-box as a RubyGem-based theme while still being easy to customize via SCSS.
 
-[link to demo post](/blog/2026/01/02/markdown-showcase.html)
+---
+
+## Installation
+
+Add this line to your Jekyll site’s `Gemfile`:
+
+```ruby
+gem "jekyll-theme-nyx"
+```
+
+Then install the gem:
+
+```sh
+bundle install
+```
+
+Next, enable the theme in your _config.yml:
+
+```yml
+theme: jekyll-theme-nyx
+```
+
+Build or serve your site to verify everything works:
+
+```sh
+bundle exec jekyll serve
+```
+
+## Usage
+
+This theme follows standard Jekyll conventions.
+
+### Layouts
+
+Nyx provides the following layouts:
+
+- `default` – base layout
+- `post` – blog post layout
+
+You can select a layout per page or post:
+
+```yml
+layout: post
+```
+
+### Styling
+
+All styles are written in SCSS and live under:
+
+```
+_sass/nyx/
+```
+
+The main entrypoint is:
+
+```
+assets/css/nyx.scss
+```
+
+If you want to override styles, you can:
+
+- copy partials from `_sass/nyx/` into your own project
+- or add custom styles after importing `nyx.scss`
+
+### Includes
+
+Reusable components live in `_includes/`, such as:
+
+- `sidebar.html`
+
+These can be overridden by copying them into your site’s `_includes/` directory.
+
+## Development
+
+To work on the theme locally:
+
+```sh
+bundle install
+bundle exec jekyll serve
+```
+
+This repository includes a dummy Jekyll site for testing theme changes.
+
+Useful tasks:
+
+```sh
+rake site    # build the dummy site
+rake build   # build the gem
+```
+
+Built gems are placed in the pkg/ directory.
+
+## Contributing 
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/Slavetomints/jekyll-theme-nyx. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/Slavetomints/jekyll-theme-nyx/blob/main/CODE_OF_CONDUCT.md). 
+
+## License 
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). 
+
+## Code of Conduct 
+
+Everyone interacting in the jekyll-theme-nyx project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/Slavetomints/jekyll-theme-nyx/blob/main/CODE_OF_CONDUCT.md).

data/jekyll-theme-nyx.gemspec

@@ -1,44 +1,42 @@
 # frozen_string_literal: true
 
 Gem::Specification.new do |spec|
-  spec.name = "jekyll-theme-nyx"
-  spec.version = "0.2.3"
-  spec.authors = ["Slavetomints"]
-  spec.email = ["me@slavetomints.com"]
+  spec.name = 'jekyll-theme-nyx'
+  spec.version = '0.3.1'
+  spec.authors = ['Slavetomints']
+  spec.email = ['me@slavetomints.com']
 
-  spec.summary = "Simple Jekyll Theme"
+  spec.summary = 'Simple Jekyll Theme'
   spec.description = <<~DESC
-  Nyx is a dark mode based Jekyll theme focused on readability,
-  clean typography, and simple blogging.
+    Nyx is a dark mode based Jekyll theme focused on readability,
+    clean typography, and simple blogging.
   DESC
-  spec.homepage = "https://github.com/Slavetomints/jekyll-theme-nyx"  
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1.0"
+  spec.homepage = 'https://github.com/Slavetomints/jekyll-theme-nyx'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 3.1.0'
 
-  spec.metadata["rubygems_mfa_required"] = "true"
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
-  spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues"
-  spec.metadata["documentation_uri"] = "#{spec.homepage}#readme"
-  spec.metadata["theme"] = "true"
-  spec.metadata["jekyll_theme"] = "true"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata['bug_tracker_uri'] = "#{spec.homepage}/issues"
+  spec.metadata['documentation_uri'] = "#{spec.homepage}#readme"
+  spec.metadata['theme'] = 'true'
+  spec.metadata['jekyll_theme'] = 'true'
 
-  
-  spec.add_runtime_dependency "jekyll", "~> 4.0"
+  spec.add_dependency 'jekyll', '~> 4.0'
 
   spec.cert_chain  = ['certs/slavetomints.pem']
-  spec.signing_key = File.expand_path("~/.ssh/gem-private_key.pem") if $0 =~ /gem\z/
+  spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem') if $0 =~ /gem\z/
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = IO.popen(%w[git ls-files -z], chdir: __dir__, err: IO::NULL) do |ls|
-  ls.readlines("\x0", chomp: true).select do |f|
-    # Only include files that actually exist
-    File.file?(File.join(__dir__, f))
+    ls.readlines("\x0", chomp: true).select do |f|
+      # Only include files that actually exist
+      File.file?(File.join(__dir__, f))
     end
   end
 
-  spec.require_paths = ["lib"]
-
+  spec.require_paths = ['lib']
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-nyx
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.1
 platform: ruby
 authors:
 - Slavetomints
@@ -60,7 +60,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/main.yml"
+- ".github/CONTRIBUTING.MD"
+- ".github/ISSUE_TEMPLATE/bug_report.yml"
+- ".github/ISSUE_TEMPLATE/config.yml"
+- ".github/ISSUE_TEMPLATE/feature_request.yml"
+- ".github/pull_request_template.md"
+- ".github/workflows/build-and-deploy.yml"
 - ".gitignore"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -69,10 +74,14 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- SECURITY.md
 - _config.yml
-- _includes/sidebar.html
+- _includes/header.html
+- _layouts/category.html
 - _layouts/default.html
 - _layouts/post.md
+- _layouts/tag.html
+- _plugins/taxonomy_pages.rb
 - _posts/2026-01-02-markdown-showcase.md
 - _sass/nyx/_base.scss
 - _sass/nyx/_code.scss
@@ -80,6 +89,10 @@ files:
 - _sass/nyx/_rouge.scss
 - _sass/nyx/_typography.scss
 - _sass/nyx/_variables.scss
+- _tabs/about.md
+- _tabs/categories.md
+- _tabs/posts.md
+- _tabs/tags.md
 - assets/css/nyx.scss
 - assets/img/black-logo.svg
 - assets/img/white-logo.svg

data/_includes/sidebar.html

@@ -1,9 +0,0 @@
-<aside id="sidebar">
-  <ul id="sidebar-list">
-    <li><a href="/">Home</a></li>
-    <li><a href="/blog">Posts</a></li>
-    <li>Tags</li>
-    <li>Categories</li>
-    <li>About</li>
-  </ul>
-</aside>