bridgetown-stoa 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a78f506b84ad2518d27d4f7cb6cfc133fcd3dae4dadd2622d3f3698ede1dbc3
-  data.tar.gz: d567d1a4059a6da89a02d9124a47230557042332983e2a13cdaeb7cbb1e4fb83
+  metadata.gz: cd608896b8fe6337dd6f18ea4142689a7075fb8b083b2e818f8e7fb2581bef94
+  data.tar.gz: c701e091bf21dbcdfc797186baf25a8c091ff39b5396db1ca7a41a3dccecd5cf
 SHA512:
-  metadata.gz: 3039e265e94aa9571ee8d8846cb988f2dc73bc75f2f8391e393db22684faea404747728e76c3434acff558faa576ea40d39769180f0e59e6395b419717b41795
-  data.tar.gz: c331e8d344ac1f991822edebd681a86e64e07cf7ee745bb343f447314bd397e5e5944d131a296ef9f5e7dba180485f30d23037b09e42cba51d410639bd02fe44
+  metadata.gz: 921ab4bca3b8dc1559db5d8bc3837a875643519925a4eed55a257c4b2c4e10444a7d7b404f1589f1d6c06c761ba83c03a10fdf180b2378a33c4275868400585b
+  data.tar.gz: bb4431c809b2eb51eb6c432d15c5a0785a0c25ea2762cba781942c97435139d31f93d60e5e68b76f6f847e685046e7e4719c3dfeb112543da8fc388ddf6b0543

data/CHANGELOG.md

@@ -9,6 +9,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - ...
 
+## [0.3.0] - 2026-05-22
+
+### Changed
+- Enabled the `yarn-add` gemspec metadata so Bridgetown sites that install the gem auto-add the `bridgetown-stoa` npm dependency. Matches the idiomatic pattern from `bridgetown-quick-search`. (`yarn-add` and `npm_add` are synonyms inside Bridgetown's plugin manager — the gemspec template's commented `npm_add` is the older name; the ecosystem has standardized on `yarn-add`.)
+- Excluded `frontend/` from the gem's `files` glob. The Tailwind partial belongs in the npm companion only; shipping it in the gem too was duplicate distribution.
+- Test fixture initializer now passes `require_gem: false` to `init :"bridgetown-stoa"` so Bridgetown's plugin manager doesn't run `install_npm_dependencies` during the test suite (which would inject a self-referencing dep into the gem's own `package.json`). The gem is already loaded by `test/helper.rb`, so the re-require was redundant anyway.
+
+## [0.2.0] - 2026-05-22
+
+### Added
+- Tailwind v4 source partial at `frontend/styles/bridgetown-stoa.css`, shipped via a companion `bridgetown-stoa` npm package. Defines `--color-stoa-*` and `--font-stoa-*` design tokens (light + dark) in an `@theme` block, sets up class-strategy dark mode via `@custom-variant dark`, and applies a baseline `html` style. Host sites `@import "bridgetown-stoa"` and `@source` the layouts from their `frontend/styles/index.css`.
+- `script/release` now also runs `npm publish` after the gem release, and pre-flights `npm whoami` so it bails before the gem push if credentials are missing.
+
+### Fixed
+- `bridgetown-stoa/layout` no longer prepends `"Index | "` to `<title>` on the home page when `src/index.md` has no explicit `title:` front-matter. (#8)
+
 ## [0.1.0] - 2026-05-22
 
 ### Changed

data/README.md

@@ -22,6 +22,29 @@ Then `bundle install` and add to `config/initializers.rb`:
 init :"bridgetown-stoa"
 ```
 
+### Styles (Tailwind v4)
+
+Stoa ships its styles as a Tailwind v4 source partial in a companion npm package (`bridgetown-stoa`), so they compose with your site's Tailwind pipeline (tree-shaken, token-overrideable).
+
+```shell
+npm install bridgetown-stoa
+```
+
+Then in `frontend/styles/index.css`, after `@import "tailwindcss";`, add two lines:
+
+```css
+@import "tailwindcss";
+@source "../../node_modules/bridgetown-stoa/layouts/**/*.serb";
+@import "bridgetown-stoa";
+```
+
+- `@source` tells Tailwind to scan Stoa's layouts for utility-class usage.
+- `@import "bridgetown-stoa"` pulls in the `@theme` tokens (`--color-stoa-*`, `--font-stoa-*`) and a small `@layer base` that styles `html` with the theme colors.
+
+Override any token by redeclaring it in your own `@theme` block after the import.
+
+Stoa uses Tailwind's **class-strategy dark mode** (`html.dark`). Toggle the `dark` class on `<html>` to switch themes; a default JS toggle that follows `prefers-color-scheme` will ship in a later release.
+
 ## Usage
 
 One layout is registered: `bridgetown-stoa/layout`. Apply it via front matter:

data/bridgetown-stoa.gemspec

@@ -11,14 +11,12 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/Guided-Rails/bridgetown-stoa"
   spec.license       = "MIT"
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|script|spec|features)/!) }
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|script|spec|features|frontend)/!) }
   spec.test_files    = spec.files.grep(%r!^test/!)
   spec.require_paths = ["lib"]
-  # Uncomment this if you wish to supply a companion NPM package and/or command features:
-  # spec.metadata = {
-  #   "npm_add" => "bridgetown-stoa@#{BridgetownStoa::VERSION}",
-  #   "bridgetown_features" => "true"
-  # }
+  spec.metadata      = {
+    "yarn-add" => "bridgetown-stoa@#{BridgetownStoa::VERSION}",
+  }
 
   spec.required_ruby_version = ">= 3.2"
 

data/layouts/bridgetown-stoa/layout.serb

@@ -4,7 +4,10 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>
-      {% if resource.data.title %}{{ resource.data.title }} | {% end %}{{ site.metadata.title }}
+      {% if resource.data.title != "Index" %}
+        {{ resource.data.title }} |
+      {% end %}
+      {{ site.metadata.title }}
     </title>
     {% if resource.data.description %}
       <meta name="description" content="{{ resource.data.description }}">

data/lib/bridgetown-stoa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BridgetownStoa
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "bridgetown-stoa",
+  "version": "0.3.0",
+  "description": "Tailwind v4 source partial and layouts for the Stoa Bridgetown documentation theme.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Guided-Rails/bridgetown-stoa.git"
+  },
+  "homepage": "https://github.com/Guided-Rails/bridgetown-stoa",
+  "main": "frontend/styles/bridgetown-stoa.css",
+  "style": "frontend/styles/bridgetown-stoa.css",
+  "exports": {
+    ".": "./frontend/styles/bridgetown-stoa.css",
+    "./layouts/*": "./layouts/*"
+  },
+  "files": [
+    "frontend/styles/",
+    "layouts/",
+    "README.md",
+    "LICENSE.txt"
+  ],
+  "peerDependencies": {
+    "tailwindcss": "^4.0.0"
+  }
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bridgetown-stoa
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Abdullah Hashim
@@ -83,10 +83,12 @@ files:
 - layouts/bridgetown-stoa/layout.serb
 - lib/bridgetown-stoa.rb
 - lib/bridgetown-stoa/version.rb
+- package.json
 homepage: https://github.com/Guided-Rails/bridgetown-stoa
 licenses:
 - MIT
-metadata: {}
+metadata:
+  yarn-add: bridgetown-stoa@0.3.0
 rdoc_options: []
 require_paths:
 - lib