bulma-turbo-themes 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6030bde47c69b18740775a31fd0fba64c9fcfb14bb09a97ec05f0154ebfa8961
+  data.tar.gz: 4edb7dd40621d67af5d8d8970459a8e0a9373fe96c1618cbaa1411cd3192210f
+SHA512:
+  metadata.gz: 5b54a84786a9c5b43ad36b348080cb8a24f2a1e1f014b7d9366b1a7da11dc854351523f7560b853ac4747735130e7087e9a408d6a1de0b24d49cdec8d3498c65
+  data.tar.gz: 97b1ee60bcac1e13768978282e32e48a666afc5646bc8a7c9e9cb1c4d7d0da2ad368bf33dd336bea4d0ce6775777bd0fae71ab0514926710b1e508c91c0cf589

data/CHANGELOG.md

@@ -0,0 +1,409 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog and this project adheres to SemVer.
+
+## [Unreleased]
+
+### Added
+
+- TBD
+
+## [0.10.8] - 2025-12-05
+
+### 🐛 Fixed
+
+- update react monorepo to v19 (#165)
+
+## [0.10.7] - 2025-12-05
+
+### 🐛 Fixed
+
+- update renovatebot/github-action digest to 4ebebab (#141)
+
+## [0.10.6] - 2025-12-05
+
+### 🐛 Fixed
+
+- update actions/create-github-app-token action to v2 (#162)
+
+## [0.10.5] - 2025-12-05
+
+### 🐛 Fixed
+
+- update actions/checkout action to v6 (#160)
+
+## [0.10.4] - 2025-12-05
+
+### 🐛 Fixed
+
+- update softprops/action-gh-release digest to a06a81a (#142)
+
+## [0.10.3] - 2025-12-05
+
+### 🐛 Fixed
+
+- update actions/checkout action to v5.0.1 (#144)
+
+## [0.10.2] - 2025-12-05
+
+### 🐛 Fixed
+
+- update astral-sh/setup-uv action to v7.1.4 (#145)
+
+## [0.10.1] - 2025-12-05
+
+### 🐛 Fixed
+
+- update actions/create-github-app-token action to v1.12.0 (#153)
+
+## [0.10.0] - 2025-12-05
+
+### ✨ Added
+
+- add full theming solution with context and hooks (#151)
+
+### 🐛 Fixed
+
+- recognize scoped conventional commits in version bump (#154)
+- update peter-evans/create-pull-request action to v7.0.11 (#148)
+- add missing egress endpoints for Bun CDN downloads
+
+## [0.9.0] - 2025-12-05
+
+### ✨ Added
+
+- migrate theme system to SASS (#143)
+
+### 🐛 Fixed
+
+- enable platformCommit for Renovate to sign commits
+- correct JavaScript reference in gem layout (#106)
+
+### 🔧 Changed
+
+- add missing egress endpoints for Bun download (#149)
+- update actions/setup-node digest to 633bb92 (#110)
+- update peter-evans/create-pull-request digest to 271a8d0 (#109)
+- update actions/setup-node digest to 2028fbc (#108)
+
+## [0.8.1] - 2025-11-16
+
+### 🐛 Fixed
+
+- update OpenSSF badge to Best Practices (#104)
+
+## [0.8.0] - 2025-11-16
+
+### ✨ Added
+
+- include layouts and data files in gem
+
+## [0.7.4] - 2025-11-16
+
+### 🐛 Fixed
+
+- add missing RubyGems endpoints to build job egress policy
+
+## [0.7.3] - 2025-11-16
+
+### 🐛 Fixed
+
+- allow bundler download cdn
+
+## [0.7.2] - 2025-11-16
+
+### 🐛 Fixed
+
+- allow release assets for gem publish
+
+## [0.7.1] - 2025-11-16
+
+### 🐛 Fixed
+
+- add cache.ruby-lang.org to publish job egress policy
+
+## [0.7.0] - 2025-11-16
+
+### ✨ Added
+
+- implement enterprise-level build/publish separation
+
+## [0.6.5] - 2025-11-16
+
+### 🐛 Fixed
+
+- add Rakefile and build-gem.sh documentation
+- improve Rakefile with best practices
+- add Rakefile and use release-gem action for trusted publishing
+
+## [0.6.4] - 2025-11-16
+
+### 🐛 Fixed
+
+- use configure-rubygems-credentials for OIDC auth
+
+## [0.6.3] - 2025-11-16
+
+### 🐛 Fixed
+
+- use OIDC trusted publisher for RubyGems release
+
+### 🔧 Changed
+
+- resolve workflow failures in gem publishing and release creation
+
+## [0.6.2] - 2025-11-16
+
+### 🐛 Fixed
+
+- add missing network endpoints for publish workflows
+- Lighthouse reports not appearing on site and deploy-pages Ruby version
+
+## [0.6.2] - 2025-11-16
+
+### 🐛 Fixed
+
+- add missing network endpoints for publish workflows
+- Lighthouse reports not appearing on site and deploy-pages Ruby version
+
+## [0.6.1] - 2025-11-16
+
+### 🐛 Fixed
+
+- add missing id-token permission and correct Ruby version
+
+## [0.6.0] - 2025-11-16
+
+### ✨ Added
+
+- use GitHub App for release automation matching py-lintro pattern
+
+### 🐛 Fixed
+
+- prevent version PR infinite loop and add download retry logic
+
+## [0.5.2] - 2025-11-15
+
+### 🐛 Fixed
+
+- handle existing PR gracefully in version bump workflow
+- add actions:write permission for workflow_dispatch triggers
+
+## [0.5.2] - 2025-11-15
+
+### 🐛 Fixed
+
+- add actions:write permission for workflow_dispatch triggers
+
+## [0.5.2] - 2025-11-15
+
+### 🐛 Fixed
+
+- trigger publish workflows directly after tag creation
+
+## [0.5.1] - 2025-11-15
+
+### 🐛 Fixed
+
+- trigger publish workflows directly after tag creation
+
+## [0.5.0] - 2025-11-15
+
+### ✨ Added
+
+- implement Jekyll gem wrapper for bulma-turbo-themes (#80)
+- add comprehensive Playwright E2E test suite with accessibility checks (#44)
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- skip pre-commit hooks in automated version PR creation
+- optimize complete release train workflow pipeline (#86)
+- separate CI build script from local development build (#84)
+- fix version PR branch checkout failure (#85)
+- add CI environment detection and explicit --no-serve flag (#82)
+- add checkout step to deployment workflows (#81)
+- add Playwright browser caching and skip E2E tests in build workflow (#79)
+- resolve hadolint binary naming and checksum verification issues (#78)
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- update dependency ruby to v3.4.7 (#83)
+- update ossf/scorecard-action digest to 4eaacf0 (#72)
+- update softprops/action-gh-release digest to 5be0e66 (#76)
+- update turbocoder13/py-lintro digest to b3fb40d (#77)
+- update actions/download-artifact digest (#71)
+- update actions/checkout digest to 08c6903 (#70)
+- update dependency ruby (#68)
+- update dependency jsdom to v27.1.0 (#67)
+- update dependency eslint to v9.39.1 (#65)
+- update dependency html-proofer to v5.1.0 (#66)
+- update dependency happy-dom to v20.0.10 (#57)
+- update softprops/action-gh-release digest to 00362be (#55)
+- update github artifact actions (#60)
+- update turbocoder13/py-lintro digest to 1e25709 (#56)
+- update actions/setup-node action to v6 (#58)
+- update actions/upload-pages-artifact action to v4 (#59)
+- update github/codeql-action digest to 71d0a56 (#61)
+- update peter-evans/create-or-update-comment action to v5 (#62)
+- update peter-evans/find-comment action to v4 (#63)
+- update sigstore/cosign-installer action to v4 (#64)
+- update ruby/setup-ruby digest to d5126b9 (#54)
+- update ossf/scorecard-action digest to ee561a8 (#53)
+- update actions/checkout digest to ff7abcd (#45)
+- update actions/github-script digest to ed59741 (#48)
+- update actions/upload-artifact digest to 330a01c (#52)
+- update actions/setup-node digest to dda4788 (#51)
+- update github/codeql-action digest to ae78991 (#50)
+- update actions/download-artifact digest to 018cc2c (#49)
+- update actions/github-script action to v8 (#47)
+- update actions/checkout action to v5 (#46)
+- update sigstore/cosign-installer action to v3.10.1 (#43)
+- update dependency happy-dom to v20.0.8 (#42)
+- update codecov/codecov-action action to v5.5.1 (#41)
+- update actions/upload-artifact action to v4.6.2 (#40)
+- update actions/setup-node action to v4.4.0 (#39)
+- update actions/upload-artifact digest to 2848b2c (#38)
+- check for existing remote branch before creating local one (#36)
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.4.0] - 2025-10-21
+
+### ✨ Added
+
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- update actions/setup-node action to v4.4.0 (#39)
+- update actions/upload-artifact digest to 2848b2c (#38)
+- check for existing remote branch before creating local one (#36)
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.4.0] - 2025-10-21
+
+### ✨ Added
+
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- update actions/upload-artifact digest to 2848b2c (#38)
+- check for existing remote branch before creating local one (#36)
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.4.0] - 2025-10-19
+
+### ✨ Added
+
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- check for existing remote branch before creating local one (#36)
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.4.0] - 2025-10-19
+
+### ✨ Added
+
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.3.0] - 2025-10-19
+
+### ✨ Added
+
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.2.0] - 2025-10-19
+
+### ✨ Added
+
+- implement PR-based release workflow system (#31)
+
+### 🐛 Fixed
+
+- remove monitoring uptime workflow (#30)
+
+### 🔧 Changed
+
+- update actions/github-script digest to ed59741 (#33)
+- update actions/checkout digest to ff7abcd (#32)
+- update dependency stylelint-config-standard to v39 (#29)
+- update dependency lint-staged to v16 (#28)
+- update typescript-eslint monorepo to v8.46.1 (#27)
+- update dependency ruby to v3.4.7 (#26)
+- update dependency eslint to v9.38.0 (#25)
+
+## [0.1.0] - 2025-10-04
+
+### Added
+
+- Initial project setup, demo site, themes, and selector

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Turbo Coder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,323 @@
+# turbo-themes
+
+Universal, accessible theme packs and a drop-in theme selector.
+
+[![Bun](https://img.shields.io/badge/bun-1.3+-black?logo=bun)](https://bun.sh/)
+[![Node.js](https://img.shields.io/badge/node.js-22-green)](https://nodejs.org/)
+[![Coverage](https://codecov.io/gh/TurboCoder13/turbo-themes/branch/main/graph/badge.svg)](https://codecov.io/gh/TurboCoder13/turbo-themes)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![Tests](https://img.shields.io/github/actions/workflow/status/TurboCoder13/turbo-themes/quality-ci-main.yml?label=tests&branch=main&logo=githubactions&logoColor=white)](https://github.com/TurboCoder13/turbo-themes/actions/workflows/quality-ci-main.yml?query=branch%3Amain)
+[![CI](https://img.shields.io/github/actions/workflow/status/TurboCoder13/turbo-themes/quality-ci-main.yml?label=ci&branch=main&logo=githubactions&logoColor=white)](https://github.com/TurboCoder13/turbo-themes/actions/workflows/quality-ci-main.yml?query=branch%3Amain)
+[![Lighthouse](https://img.shields.io/github/actions/workflow/status/TurboCoder13/turbo-themes/reporting-lighthouse-ci.yml?label=lighthouse&branch=main)](https://github.com/TurboCoder13/turbo-themes/actions/workflows/reporting-lighthouse-ci.yml?query=branch%3Amain)
+
+[![CodeQL](https://github.com/TurboCoder13/turbo-themes/actions/workflows/security-codeql.yml/badge.svg?branch=main)](https://github.com/TurboCoder13/turbo-themes/actions/workflows/security-codeql.yml?query=branch%3Amain)
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11471/badge)](https://www.bestpractices.dev/projects/11471)
+[![SBOM](https://img.shields.io/badge/SBOM-enabled-brightgreen)](SECURITY.md)
+[![Download SBOM](https://img.shields.io/badge/SBOM-download_latest-blue?logo=github)](https://github.com/TurboCoder13/turbo-themes/actions/workflows/security-sbom.yml)
+
+[![npm](https://img.shields.io/npm/v/%40turbocoder13%2Fturbo-themes)](https://www.npmjs.com/package/@turbocoder13/turbo-themes)
+[![RubyGems](https://img.shields.io/gem/v/turbo-themes.svg)](https://rubygems.org/gems/turbo-themes)
+
+## Features
+
+- Catppuccin, Dracula, GitHub (light/dark) flavor packs
+- Accessible theme selector with keyboard and screen reader support
+- Inline or link-based CSS delivery; CSP-friendly
+- Tested with coverage, Lighthouse CI, and stylelint
+- Advanced Bulma customization (breakpoints, spacing, shadows, mixins)
+- Lazy-loaded themes with performance optimizations
+- Full Bulma Sass variable integration
+
+## Installation
+
+### For Jekyll Sites (Recommended)
+
+Install as a Ruby gem:
+
+```ruby
+# Gemfile
+gem "turbo-themes", "~> 0.10"
+```
+
+```yaml
+# _config.yml
+theme: turbo-themes
+```
+
+Then run:
+
+```bash
+bundle install
+bundle exec jekyll serve
+```
+
+Assets are automatically available - no copying needed!
+
+### Advanced Theming
+
+For advanced customization options including custom breakpoints, spacing, shadows, and Bulma mixins, see the [Advanced Theming Guide](docs/ADVANCED-THEMING.md).
+
+### For Non-Jekyll Projects
+
+Install via Bun (recommended) or npm:
+
+```bash
+# Using Bun (recommended - 5-10x faster)
+bun add @turbocoder13/turbo-themes
+
+# Using npm
+npm install @turbocoder13/turbo-themes
+```
+
+## Quick start
+
+### Jekyll Sites
+
+1. Install the gem (see above)
+2. Include CSS links in your layout:
+
+```html
+<link
+  id="theme-global-css"
+  rel="stylesheet"
+  href="{{ '/assets/css/themes/global.css' | relative_url }}"
+/>
+<link id="theme-flavor-css" rel="stylesheet" href="#" />
+```
+
+1. Add selector markup and initialize:
+
+```html
+<div class="navbar-item has-dropdown is-hoverable">
+  <button
+    class="navbar-link"
+    id="theme-flavor-trigger"
+    type="button"
+    aria-haspopup="true"
+    aria-expanded="false"
+    aria-controls="theme-flavor-menu"
+  >
+    <span class="icon is-small" id="theme-flavor-trigger-icon"></span>
+    Theme
+  </button>
+  <div class="navbar-dropdown" id="theme-flavor-menu" aria-labelledby="theme-flavor-trigger">
+    <div class="dropdown-content" id="theme-flavor-items"></div>
+  </div>
+</div>
+<div class="select is-rounded is-small is-hidden">
+  <select id="theme-flavor-select" aria-label="Theme flavor" disabled></select>
+</div>
+```
+
+```html
+<script src="{{ '/assets/js/theme-selector.js' | relative_url }}"></script>
+```
+
+### Non-Jekyll Projects
+
+1. Copy CSS files from `node_modules/@turbocoder13/turbo-themes/assets/css/themes/` to your project:
+   - `global.css` (required)
+   - Flavor CSS files (e.g., `catppuccin-mocha.css`, `dracula.css`, `github-dark.css`) - copy the ones you want to use
+2. Include CSS links (adjust paths to match your project structure):
+
+```html
+<link id="theme-global-css" rel="stylesheet" href="/assets/css/themes/global.css" />
+<link id="theme-flavor-css" rel="stylesheet" href="#" />
+```
+
+1. Add selector markup and initialize:
+
+```html
+<div class="navbar-item has-dropdown is-hoverable">
+  <button
+    class="navbar-link"
+    id="theme-flavor-trigger"
+    type="button"
+    aria-haspopup="true"
+    aria-expanded="false"
+    aria-controls="theme-flavor-menu"
+  >
+    <span class="icon is-small" id="theme-flavor-trigger-icon"></span>
+    Theme
+  </button>
+  <div class="navbar-dropdown" id="theme-flavor-menu" aria-labelledby="theme-flavor-trigger">
+    <div class="dropdown-content" id="theme-flavor-items"></div>
+  </div>
+</div>
+<div class="select is-rounded is-small is-hidden">
+  <select id="theme-flavor-select" aria-label="Theme flavor" disabled></select>
+</div>
+```
+
+```ts
+import { initTheme, wireFlavorSelector } from '@turbocoder13/turbo-themes';
+
+document.addEventListener('DOMContentLoaded', () => {
+  initTheme(document, window);
+  wireFlavorSelector(document, window);
+});
+```
+
+### React Native / Cross-Platform
+
+This package provides platform-agnostic design tokens that work in React Native, Expo, and other non-web environments.
+
+#### Installation
+
+```bash
+bun add @turbocoder13/turbo-themes
+# or
+npm install @turbocoder13/turbo-themes
+```
+
+#### Basic Usage (Without Context)
+
+```tsx
+import { useTheme, useThemeColors } from '@turbocoder13/turbo-themes/tokens/react-native';
+
+function MyComponent() {
+  const { colors, styles, theme } = useTheme('catppuccin-mocha');
+
+  return (
+    <View style={styles.container}>
+      <Text style={styles.h1}>{theme.label}</Text>
+      <Text style={[styles.text, { color: colors.brandPrimary }]}>
+        Primary color text
+      </Text>
+    </View>
+  );
+}
+```
+
+#### With ThemeProvider (Recommended)
+
+```tsx
+import { ThemeProvider, useThemeContext } from '@turbocoder13/turbo-themes/tokens/react-native';
+import { useColorScheme } from 'react-native';
+
+// Wrap your app with ThemeProvider
+function App() {
+  return (
+    <ThemeProvider
+      useColorScheme={useColorScheme}
+      followSystem
+      lightTheme="catppuccin-latte"
+      darkTheme="catppuccin-mocha"
+    >
+      <MyApp />
+    </ThemeProvider>
+  );
+}
+
+// Use the theme in any component
+function MyApp() {
+  const { colors, styles, setTheme, toggleAppearance, appearance } = useThemeContext();
+
+  return (
+    <View style={styles.container}>
+      <Text style={styles.h1}>Welcome!</Text>
+      <Button
+        title={`Switch to ${appearance === 'dark' ? 'light' : 'dark'}`}
+        onPress={toggleAppearance}
+      />
+    </View>
+  );
+}
+```
+
+#### Available Exports
+
+| Import Path | Use Case |
+|-------------|----------|
+| `@turbocoder13/turbo-themes/tokens` | Platform-agnostic tokens (pure data) |
+| `@turbocoder13/turbo-themes/tokens/react-native` | React Native utilities, hooks, and context |
+| `@turbocoder13/turbo-themes/tokens.json` | JSON tokens for Flutter, Swift, Kotlin |
+| `@turbocoder13/turbo-themes/css/*` | CSS files for web |
+
+#### Pre-built Styles
+
+The React Native module includes pre-built styles for common components:
+
+- **Layout**: `container`, `safeArea`, `centered`, `row`
+- **Typography**: `h1`-`h6`, `text`, `textSecondary`, `caption`, `label`, `link`
+- **Components**: `card`, `cardElevated`, `button`, `buttonOutline`, `input`, `listItem`, `badge`, `tag`, `divider`
+- **State Colors**: `success`, `warning`, `danger`, `info`
+
+Plus design tokens for `spacing`, `typography`, `borderRadius`, and `shadows`.
+
+## Testing
+
+This project includes comprehensive testing:
+
+- **Unit Tests**: Vitest with coverage reporting
+- **E2E Tests**: Playwright with Page Object Model pattern
+- **Accessibility Tests**: axe-core integration for WCAG compliance
+- **Visual Regression**: Playwright screenshots and snapshots
+
+Run tests:
+
+```bash
+# Using Bun (recommended)
+bun run test          # Unit tests with coverage
+bun run e2e           # All E2E tests
+bun run e2e:smoke     # Smoke tests only
+bun run e2e:visual    # Visual regression tests
+bun run e2e:a11y      # Accessibility tests
+bun run e2e:ui        # Playwright UI mode
+
+# Using npm (also works)
+npm test              # Unit tests with coverage
+npm run e2e           # All E2E tests
+```
+
+For detailed E2E testing documentation, see `docs/E2E-TESTING.md`.
+
+## Development Setup
+
+### Prerequisites
+
+- **Bun** 1.3+ (recommended) - [Install Bun](https://bun.sh/docs/installation)
+- **Node.js** 22+ (alternative)
+- **Ruby** 3.3+ with Bundler (for Jekyll demo site)
+
+### Quick Start
+
+```bash
+# Clone and install
+git clone https://github.com/TurboCoder13/turbo-themes.git
+cd turbo-themes
+bun install
+bundle install
+
+# Build and serve
+bun run build
+bun run build:themes
+bun run serve
+```
+
+### Why Bun?
+
+This project uses [Bun](https://bun.sh/) as its primary JavaScript runtime for:
+
+- **5-10x faster** package installation
+- **10x faster** script startup time
+- **~40% reduction** in CI build times
+- Full npm compatibility (works with all existing packages)
+
+## Documentation
+
+- Code of Conduct: see `CODE_OF_CONDUCT.md`
+- Contributing Guide: see `CONTRIBUTING.md`
+- Security Policy: see `SECURITY.md`
+- Release process: see `docs/RELEASE-TRAIN.md`
+- E2E Testing: see `docs/E2E-TESTING.md`
+- Workflows & Actions: see `.github/workflows/README.md` and `.github/actions/README.md`
+- Scripts: see `scripts/README.md`
+
+## Governance
+
+See `GOVERNANCE.md` and `MAINTAINERS.md`.
+
+## License
+
+MIT © Turbo Coder

data/lib/bulma-turbo-themes.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module BulmaTurboThemes
+  VERSION = "0.5.0"
+end
+
+require "turbo-themes"
+

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: bulma-turbo-themes
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Turbo Coder
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: turbo-themes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: This gem has been renamed to 'turbo-themes'. Please update your Gemfile
+  to `gem "turbo-themes"`.
+email:
+- turbocoder13@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/bulma-turbo-themes.rb
+homepage: https://github.com/TurboCoder13/turbo-themes
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/TurboCoder13/turbo-themes/issues
+  changelog_uri: https://github.com/TurboCoder13/turbo-themes/blob/main/CHANGELOG.md
+  documentation_uri: https://turbocoder13.github.io/turbo-themes/
+  homepage_uri: https://github.com/TurboCoder13/turbo-themes
+  source_code_uri: https://github.com/TurboCoder13/turbo-themes
+post_install_message: |
+  ⚠️  DEPRECATION WARNING ⚠️
+  The 'bulma-turbo-themes' gem has been renamed to 'turbo-themes'.
+  Please update your Gemfile:
+    gem "turbo-themes"
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'DEPRECATED: Use ''turbo-themes'' gem instead.'
+test_files: []