frozen_rails 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3e70fbae47b9cfd6742a06eb54721f5f1f182afd4ab044b19d796d3a36a08b0
-  data.tar.gz: 468e981b06f99a821b3a58bdd8bb02f6c7fc51abdb97ea73ead08e6f93ed5f66
+  metadata.gz: 79009959a35c4871ccbb2848610e9d79f5403eba5f03364822ced61d5f22cc48
+  data.tar.gz: 9f590dcde282590241cc28fe84f0bc1030bd2163e204915be7a84d5f62ed4555
 SHA512:
-  metadata.gz: 14f2cfa35628c1837d58828ba17ca68eefe82a6b1294e13532352000735f9ed0586cac0e55f61ca29a27f52d9ae043261dab742a04b186b7478e53b1af5170ee
-  data.tar.gz: 3637971df5425a6dd75e9f8ccd6ceeafca2d86dffb131f29eb57788cc698460b5d3edc5aadaba69f1923640ce38d319fd8915643b506f674349f4aa8b9c1ccdc
+  metadata.gz: d7c120056fdfcd623249e6005551a1b3b4c847238285c956b6c98064566df5532de01ffe85d2f300ed2e2edae2748600af140b92e850f3d4836c6dd3abe4907d
+  data.tar.gz: 26dcf155f28dfdf23a85107d310a22f9d1f131a45bb4bb7b0674a5fe59ae1f0424d4592513978359bed24708d34dc370c0bf6b4255dc82e98e74c24ea55ba40e

data/CHANGELOG.md

@@ -1,3 +1,14 @@
-# Change log
+# Changelog
+
+> :warning: This project is not inteded for public usage yet.
+
+I will start keeping a changelog as soon as that happens.
+
+This project adheres to [Break Versioning](https://www.taoensso.com/break-versioning).
+
+## [Unreleased]
+
+### Breaking
+
+### Non-breaking
 
-## master

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Klaus Weidinger
+Copyright (c) 2025 Klaus Weidinger
 
 MIT License
 

data/README.md

@@ -3,113 +3,81 @@
 
 # Frozen Rails
 
-DISCLAIMER: I generated this repo with AI and haven't tested it yet.
-I will verify manually verify the functionality and use AI to generate a test suite as soon as I get to it. Until then, use at your own risk.
+This repo automates the instructions from [rails-static.com](https://rails-static.com) and a lot of additional setup which was created by me.
 
-This repo automates the instructions from [rails-static.com](https://rails-static.com) and some additional setup which was created by me.
-
-Running the full setup `bin/rails g frozen:rails` should turn a fresh Rails application into a full static-site generator that supports Markdown AND structured data (SQLite). The SSG is very developer-focused and might be cumbersome to use for non-devs.
+Running the full setup `bin/rails g frozen:rails` turns a fresh Rails application into a full static site generator that supports Markdown AND structured data (SQLite). The SSG is very developer-focused and might be cumbersome to use for non-devs.
 
 ## Installation
 
-Adding to a gem:
-
-```ruby
-# my-cool-gem.gemspec
-Gem::Specification.new do |spec|
-  # ...
-  spec.add_dependency "frozen_rails"
-  # ...
-end
-```
-
-Or adding to your project:
-
-```ruby
-# Gemfile
-gem "frozen_rails"
+```bash
+bundle add frozen_rails
 ```
 
-### Supported Ruby versions
+## Prerequisites
 
-- Ruby (MRI) >= 3.2.0
-- Rails >= 8.1
+- Ruby with `bundler` installed
+- nvm
 
 ## Usage
 
-The gem ships with Rails generators under the `frozen` namespace. After including `frozen_rails` in your Rails application the following generators will be available:
-
+The gem ships with Rails generators under the `frozen` namespace. You can run them with:
 ```bash
-# ✅ passes, ✅ works correctly, ❌ has test suite
-
-# - Adds `decant` with a custom extension.
-# - Adds `kramdown`, `rouge` and ERB interpolation for `.md` files.
-# - Adds application scaffold.
-
-bin/rails g frozen:md
-# - Prompts for a rouge theme. Pass `--rouge_theme=name` to run non-interactive.
+bin/rails g frozen:GENERATOR_NAME
 ```
 
-```bash
-# ✅ passes, ✅ works correctly, ❌ has test suite
+The following generators are available:
 
-# - Adds `parklife` and configures ActiveStorage support
-# - Adds support for GitLab CI
+| Generator | Functionality |
+| --- | --- |
+| `frozen:rails` | Runs `frozen:md`, `frozen:ssg`, `frozen:db` and `frozen:ui` |
+| `frozen:md` | Sets up Markdown processing similar to `rails-static.com` |
+| `frozen:ssg` | Sets up deploying to GitHub & GitLab pages, similar to `rails-static.com` |
+| `frozen:db` | Sets up `static_db`, `avo`, `friendly_id` and fully customizes `bin/rails g scaffold` |
+| `frozen:ui` | Sets up `view_component`, `lookbook`, `esbuild`, `unpoly`, `jasmine` and fully customizes `bin/rails g component` |
 
-bin/rails g frozen:ssg
-```
+## More details
 
 ```bash
-# ✅ passes, ✅ works correctly, ❌ has test suite
-
-# - Adds `sqlite_extensions-uuid`
-# - Adds `static_db`
-# - Adds `friendly_id`
-# - Adds `avo`
-# - Adjusts Rails scaffold generator and migration generator to be more helpful
-
-bin/rails g frozen:db
+bin/rails g frozen:md
 ```
+- `decant` (picks up Markdown files and provides a nice interface)
+- `kramdown` (Markdown processing) with ERB interpolation
+- `rouge` (syntax highlighting for Markdown code blocks)
+- Routes for pages and categories.
 
-```bash
-# ✅ passes, ❓ works correctly, ❌ has test suite
-
-# - SEO helpers
-# - sitemap/robots skeleton
-
-bin/rails g frozen:seo
-```
+---
 
 ```bash
-# FUTURE: frozen:erb
-
-# - view_component
-# - herb
-# - lookbook
+bin/rails g frozen:ssg
 ```
+- `parklife` with ActiveStorage config (crawls rack apps and emits a static site)
+- GitHub pages deployment
+- GitLab pages deployment
 
-```bash
-# ✅ passes, ❓ works correctly, ❌ has test suite
-
-# - water.css
-# - sample importmap pin
-# - Hotwire Spark & Action Cable configuration
-# - Stimulus hotkey controller
-
-bin/rails g frozen:ui
-```
+---
 
 ```bash
-# ✅ passes, ❓ works correctly, ❌ has test suite
+bin/rails g frozen:db
+```
+- `static_db` (SQLite <-> YAML converter)
+- `sqlite_extensions-uuid` (SQLite UUID support to avoid YAML merge conflicts)
+- `friendly_id` (for prettier URLs)
+- `avo` (a full admin panel)
+- Adjusts `bin/rails g scaffold`
 
-# Full Rails setup (runs all frozen generators in order)
+---
 
-bin/rails g frozen:rails
-```
 
 ```bash
-# FUTURE: frozen:meetup
+bin/rails g frozen:ui
 ```
+- `esbuild` and `precompiled_assets` (Rails asset pipeline alternative)
+- `Unpoly` (Hotwire alternative)
+- `water.css` (CSS base theme)
+- `Jasmine` (JS test runner)
+- `view_component`
+- `lookbook`
+- Adjusts `bin/rails g component`
 
 ## Contributing
 

data/lib/frozen_rails/appendable.rb

@@ -3,8 +3,15 @@ module Appendable
 
   private
 
-  def append_to_application_config(content)
-    inject_into_file "config/application.rb", optimize_indentation("\n#{content}", 4), before: /  end\nend(?:\n)\z/, verbose: false
+  def append_to_application_config(content, env: nil)
+    case env
+    when nil
+      inject_into_file "config/application.rb", optimize_indentation("\n#{content}", 4), before: /  end\nend(?:\n)\z/, verbose: false
+    when "development", "production", "test"
+      inject_into_file "config/environments/#{env}.rb", optimize_indentation("\n#{content}", 2), before: /end(?:\n)\z/, verbose: false
+    else
+      raise "Unknown env: #{env}"
+    end
   end
 
   def append_to_routes(content)

data/lib/frozen_rails/copyable.rb

@@ -3,10 +3,15 @@ module Copyable
 
   private
 
-  def copy_directory(source, target, **options)
+  def copy_directory(source, target, hidden: true, **options)
     base = File.join(self.class.source_root, source)
-    Dir.glob("#{base}/**/*").each do |path|
+
+    glob_options = hidden ? [ File::FNM_DOTMATCH ] : []
+
+    Dir.glob("#{base}/**/*", *glob_options).each do |path|
       next if File.directory?(path)
+      next if hidden && (File.basename(path) == "." || File.basename(path) == "..")
+
       rel = path.delete_prefix("#{base}/")
       copy_file "#{source}/#{rel}", "#{target}/#{rel}", **options
     end

data/lib/frozen_rails/generator.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require "rails/generators"
 require "frozen_rails/appendable"
 require "frozen_rails/bundleable"

data/lib/frozen_rails/taggable.rb

@@ -24,8 +24,9 @@ module Taggable
 
   def add_frozen_gemfile_tags(env: nil)
     unless File.read("Gemfile").include?(frozen_start_tag(env:))
-      newlines = env ? "\n" : "\n\n"
-      tags = "#{frozen_start_tag(env:)}#{newlines}#{frozen_end_tag(env:)}"
+      space_between = env ? "\n" : "\n\n"
+      space_after = env ? "\n" : ""
+      tags = "#{frozen_start_tag(env:)}#{space_between}#{frozen_end_tag(env:)}#{space_after}"
       insert_into_file "Gemfile", tags, after: frozen_tags_after(env:)
     end
   end

data/lib/frozen_rails/version.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module FrozenRails # :nodoc:
-  VERSION = "0.0.5"
+  VERSION = "0.0.7"
 end

data/lib/frozen_rails.rb

@@ -1,3 +1 @@
-# frozen_string_literal: true
-
 require "frozen_rails/version"

data/lib/generators/frozen/db_generator.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require "frozen_rails/generator"
 
 module Frozen
@@ -48,8 +46,7 @@ module Frozen
         append_to_application_config <<~RUBY
           # frozen:db
           config.generators do |g|
-            g.orm :active_record, primary_key_type: :uuid
-            g.test_framework nil
+            g.orm :active_record, primary_key_type: :string
             g.helper nil
           end
           config.active_storage.draw_routes = true
@@ -116,7 +113,7 @@ module Frozen
           end
         RUBY
 
-        run "b rubocop -a config/initializers/avo.rb"
+        run "bin/rubocop -a config/initializers/avo.rb"
       end
 
       def migrate_and_cleanup_db

data/lib/generators/frozen/md_generator.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require "frozen_rails/generator"
 
 module Frozen
@@ -55,6 +53,11 @@ module Frozen
         RUBY
       end
 
+      def prepare_rouge
+        copy_directory "assets/rouge", "app/assets/rouge"
+        copy_file "assets/application.css", "app/assets/application.css", force: true
+      end
+
       def generate_rouge_css_stylesheet
         theme = options[:rouge_theme]
 
@@ -77,7 +80,7 @@ module Frozen
         theme ||= "github"
 
         say_status :info, "Generating Rouge CSS for theme #{theme}", :blue
-        run "rougify style #{theme} > app/assets/stylesheets/rouge.css"
+        run "rougify style #{theme} > app/assets/rouge/rouge.css"
       end
     end
   end

data/lib/generators/frozen/rails_generator.rb

@@ -1,36 +1,28 @@
-# frozen_string_literal: true
-
 require "rails/generators"
 require "frozen_rails/taggable"
 
 module Frozen
   module Generators
-    # A meta-generator that runs the other frozen generators in a sensible order.
     class RailsGenerator < Rails::Generators::Base
       include Taggable
 
-      desc "Run all frozen setup generators (md, db, seo, ui, dx, ssg)"
+      desc "Run all frozen setup generators (md, ssg, db, ui, seo)"
 
-      # The method name doesn't matter much; Thor runs all public methods in
-      # order defined by source.
       def run_all
         say_status :info, "invoking frozen:md"
         invoke "frozen:md", [], cleanup_frozen_tags: false
 
+        say_status :info, "invoking frozen:ssg"
+        invoke "frozen:ssg", [], cleanup_frozen_tags: false
+
         say_status :info, "invoking frozen:db"
         invoke "frozen:db", [], cleanup_frozen_tags: false
 
-        say_status :info, "invoking frozen:seo"
-        invoke "frozen:seo", [], cleanup_frozen_tags: false
-
         say_status :info, "invoking frozen:ui"
         invoke "frozen:ui", [], cleanup_frozen_tags: false
 
-        say_status :info, "invoking frozen:dx"
-        invoke "frozen:dx", [], cleanup_frozen_tags: false
-
-        say_status :info, "invoking frozen:ssg"
-        invoke "frozen:ssg", [], cleanup_frozen_tags: false
+        # say_status :info, "invoking frozen:seo"
+        # invoke "frozen:seo", [], cleanup_frozen_tags: false
 
         cleanup_all_frozen_tags!
       end

data/lib/generators/frozen/seo_generator.rb

@@ -1,17 +1,15 @@
-# frozen_string_literal: true
-
 require "frozen_rails/generator"
 
 module Frozen
   module Generators
     class SeoGenerator < FrozenRails::Generator
-      source_root File.expand_path("templates", __dir__)
+      source_root File.expand_path("templates/seo", __dir__)
 
       desc "Add SEO helpers, metadata partials and sitemap/robots models"
 
       # add meta partial and update layout
       def create_og_partial
-        template "seo/_og_meta_tags.html.erb", "app/views/layouts/_og_meta_tags.html.erb"
+        template "_og_meta_tags.html.erb", "app/views/layouts/_og_meta_tags.html.erb"
       end
 
       def inject_layout_tags
@@ -96,9 +94,9 @@ module Frozen
 
       # sitemap models
       def create_sitemap_models
-        template "seo/sitemap.rb", "app/models/sitemap.rb"
-        template "seo/sitemap_entry.rb", "app/models/sitemap/entry.rb"
-        template "seo/robots_generatable.rb", "app/models/sitemap/robots_generatable.rb"
+        template "sitemap.rb", "app/models/sitemap.rb"
+        template "sitemap_entry.rb", "app/models/sitemap/entry.rb"
+        template "robots_generatable.rb", "app/models/sitemap/robots_generatable.rb"
       end
 
       def remove_default_robots

data/lib/generators/frozen/ssg_generator.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require "frozen_rails/generator"
 
 module Frozen

data/lib/generators/frozen/templates/db/database.yml

@@ -14,5 +14,18 @@ test:
   database: storage/test.sqlite3
 
 production:
-  <<: *default
-  database: storage/production.sqlite3
+  primary:
+    <<: *default
+    database: storage/production.sqlite3
+  cache:
+    <<: *default
+    database: storage/production_cache.sqlite3
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *default
+    database: storage/production_queue.sqlite3
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *default
+    database: storage/production_cable.sqlite3
+    migrations_paths: db/cable_migrate

data/lib/generators/frozen/templates/db/initializers/skip_controller_tests_and_helpers.rb

@@ -0,0 +1,9 @@
+ActiveSupport.on_load(:active_record) do
+  require "rails/generators"
+  require "rails/generators/rails/scaffold_controller/scaffold_controller_generator"
+
+  Rails::Generators::ScaffoldControllerGenerator.class_eval do
+    remove_hook_for :test_framework
+    remove_hook_for :helper
+  end
+end

data/lib/generators/frozen/templates/db/lib/generators/avo/resource/resource_generator.rb

@@ -5,7 +5,7 @@ module Generators
     class ResourceGenerator
       no_tasks do
         def field_string(name, type, options)
-          return "field :slug, as: :id, format_using: -> { link_to value, main_app.polymorphic_path(record) }" if name.to_sym == :slug
+          return "field :slug, as: :id, format_using: -> { link_to value, main_app.polymorphic_path(record), \"data-turbo\": false }" if name.to_sym == :slug
           "field :#{name}, as: :#{type}#{options}"
         end
 

data/lib/generators/frozen/templates/db/lib/templates/active_record/model/model.rb.tt

@@ -2,7 +2,18 @@
 class <%= class_name %> < <%= parent_class_name.classify %>
 <% if attributes.any? { |a| a.name.to_s == "slug" } -%>
   include FriendlyId
-  friendly_id :<%= attributes.reject { |a| a.name.to_s == "slug" }.select { |a| a.type.to_s == "string" }.first.name  %>
+<% if (derived_from = attributes.reject { |a| a.name.to_s == "slug" }.select { |a| a.type.to_s == "string" }.first) -%>
+  friendly_id :<%= derived_from.name %>
+<% else -%>
+  friendly_id :slug_candidates
+
+  # TODO: implement
+  def slug_candidates
+    [
+      "TODO"
+    ]
+  end
+<% end -%>
 <% end -%>
 <% attributes.select(&:reference?).each do |attribute| -%>
   belongs_to :<%= attribute.name %><%= ", polymorphic: true" if attribute.polymorphic? %>

data/lib/generators/frozen/templates/db/lib/templates/erb/scaffold/index.html.erb.tt

@@ -1,14 +1,20 @@
-<p style="color: green"><%%= notice %></p>
-
 <%% content_for :title, "<%= human_name.pluralize %>" %>
 
 <h1><%= human_name.pluralize %></h1>
 
-<div id="<%= plural_table_name %>">
+<%% if Rails.env.development? %>
+  <p>
+    <%%= link_to "✏️", avo.resources_<%= index_helper(type: :path) %>, "up-follow": false %>
+  </p>
+<%% end %>
+
+<ul id="<%= plural_table_name %>">
   <%% @<%= plural_table_name %>.each do |<%= singular_table_name %>| %>
-    <%%= render <%= singular_table_name %> %>
-    <p>
-      <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(singular_table_name) %> %>
-    </p>
+    <li>
+      <%%= render <%= singular_table_name %> %>
+      <p>
+        <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(singular_table_name) %> %>
+      </p>
+    </li>
   <%% end %>
-</div>
+</ul>

data/lib/generators/frozen/templates/db/lib/templates/erb/scaffold/partial.html.erb.tt

@@ -1,4 +1,4 @@
-<div id="<%%= dom_id <%= singular_name %> %>">
+<article id="<%%= dom_id <%= singular_name %> %>">
 <% attributes.reject(&:password_digest?).each do |attribute| -%>
   <p>
     <strong><%= attribute.human_name %>:</strong>
@@ -14,4 +14,4 @@
   </p>
 
 <% end -%>
-</div>
+</article>

data/lib/generators/frozen/templates/db/lib/templates/erb/scaffold/show.html.erb.tt

@@ -1,10 +1,11 @@
-<p style="color: green"><%%= notice %></p>
+<%% content_for :title, "<%= human_name %>: #{@<%= singular_table_name %>.slug}" %>
 
 <%%= render @<%= singular_table_name %> %>
 
-<div>
-  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
-  <%% if Rails.env.development? %>
-    <%%= link_to "Edit", avo.resources_<%= show_helper(type: :path) %> %>
-  <%% end %>
-</div>
+<%% if Rails.env.development? %>
+  <p>
+    <%%= link_to "✏️", avo.resources_<%= show_helper(type: :path) %>, "up-follow": false %>
+  </p>
+<%% end %>
+
+<%%= link_to "Back to all <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>

data/lib/generators/frozen/templates/md/assets/application.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css.
+ *
+ * With Propshaft, assets are served efficiently without preprocessing steps. You can still include
+ * application-wide styles in this file, but keep in mind that CSS precedence will follow the standard
+ * cascading order, meaning styles declared later in the document or manifest will override earlier ones,
+ * depending on specificity.
+ *
+ * Consider organizing styles into separate files for maintainability.
+ *
+ *= require rouge/revert
+ *= require rouge/rouge
+ */

data/lib/generators/frozen/templates/md/assets/rouge/README.md

@@ -0,0 +1,7 @@
+# rouge syntax highlighting
+
+Put your `rouge.css` stylesheet into this directory.
+
+```bash
+rougify style THEME > app/assets/rouge/rouge.css
+```

data/lib/generators/frozen/templates/md/assets/rouge/revert.css

@@ -0,0 +1,11 @@
+/*
+  Revert all previous styles and reset to the user agent defaults.
+  The rouge "module" needs to be last in the CSS bundle or later
+  styles will mess up the syntax highlighting again.
+  This intentionally removes our base theme so the rouge styles win.
+*/
+.highlight,
+.highlight * {
+  all: revert;
+}
+/* Manually re-apply spacing rules below, if desired. */

data/lib/generators/frozen/templates/md/views/categories/index.html.erb

@@ -1,5 +1,7 @@
-<nav>
+<h1>All categories</h1>
+
+<ul>
   <% @categories.each do |category| %>
-    <%= link_to category %>
+    <li><%= link_to category %></li>
   <% end %>
-</nav>
+</ul>

data/lib/generators/frozen/templates/md/views/categories/show.html.erb

@@ -1,13 +1,9 @@
-<nav>
-  <%= link_to "Back to all categories", categories_path %>
-</nav>
+<%= link_to "Back to all categories", categories_path %>
 
-<h1><%= @category.title %></h1>
+<h1><%= @category.title %> - Articles</h1>
 
 <ul>
-<% @category.pages.each do |page| %>
-  <li>
-    <%= link_to page %>
-  </li>
-<% end %>
+  <% @category.pages.each do |page| %>
+    <li><%= link_to page %></li>
+  <% end %>
 </ul>

data/lib/generators/frozen/templates/md/views/pages/show.html.erb

@@ -1,5 +1,8 @@
-<% @page.categories.each do |category| %>
-  <%= link_to category %>
-<% end %>
+<span>
+  Categories:
+  <% @page.categories.each do |category| %>
+    <%= link_to category %>
+  <% end %>
+</span>
 
 <%= render_content_from @page %>

data/lib/generators/frozen/templates/ui/application.html.erb

@@ -0,0 +1,32 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= content_for(:title) || "Test Freeze" %></title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="application-name" content="Test Freeze">
+    <meta name="mobile-web-app-capable" content="yes">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <%= yield :head %>
+
+    <%# Enable PWA manifest for installable apps (make sure to enable in config/routes.rb too!) %>
+    <%# = tag.link rel: "manifest", href: pwa_manifest_path(format: :json) %>
+
+    <link rel="icon" href="/icon.png" type="image/png">
+    <link rel="icon" href="/icon.svg" type="image/svg+xml">
+    <link rel="apple-touch-icon" href="/icon.png">
+    <%# Use propshaft in development and precompiled_assets in production. Very brittle. %>
+    <% if Rails.env.development? %>
+      <%= stylesheet_link_tag :app %>
+    <% else %>
+      <%= stylesheet_link_tag "application" %>
+    <% end %>
+    <%= javascript_include_tag "application", type: "module", defer: true %>
+  </head>
+
+  <body>
+    <%= yield %>
+  </body>
+</html>

data/lib/generators/frozen/templates/ui/application_component.rb

@@ -0,0 +1,2 @@
+class ApplicationComponent < ViewComponent::Base
+end

data/lib/generators/frozen/templates/ui/assets/application.js

@@ -0,0 +1,4 @@
+import "./theme"
+import "./unpoly"
+import "./components"
+import "./rouge"