bunko 0.2.0

data/lib/tasks/templates/controllers/controller.rb.tt

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+class <%= controller_name %> < ApplicationController
+  bunko_collection :<%= collection_name %>
+
+  # The bunko_collection method automatically provides index and show actions.
+  #
+  # To customize, you can override these methods:
+  #
+  # def index
+  #   super # calls bunko_collection's index
+  #   # Add your customizations here
+  # end
+  #
+  # def show
+  #   super # calls bunko_collection's show
+  #   # Add your customizations here
+  # end
+  #
+  # Available instance variables in your views:
+  # - @posts (index action)
+  # - @post (show action)
+  # - @collection_name
+  # - @pagination
+end

data/lib/tasks/templates/controllers/pages_controller.rb.tt

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class PagesController < ApplicationController
+  def show
+    # Extract page slug from request path (not user-controllable params)
+    # This prevents path traversal attacks via query string manipulation
+    # e.g., GET /about?page=../../admin/users
+    page_slug = request.path.split('/').reject(&:empty?).last
+
+    @post = Post.published.find_by(
+      post_type: PostType.find_by(name: "pages"),
+      slug: page_slug
+    )
+
+    unless @post
+      raise ActiveRecord::RecordNotFound, "Page not found"
+    end
+
+    # Check if a custom view exists for this page
+    # Use DB-validated slug to prevent rendering arbitrary templates
+    # e.g., app/views/pages/about.html.erb
+    if template_exists?(@post.slug, "pages")
+      render @post.slug
+    else
+      # Otherwise render the default show.html.erb
+      render :show
+    end
+  end
+end

data/lib/tasks/templates/db/migrate/create_post_types.rb.tt

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class CreatePostTypes < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :post_types do |t|
+      t.string :name, null: false  # Identifier (e.g., "blog", "case_studies")
+      t.string :title, null: false # Display name (e.g., "Blog", "Case Studies")
+
+      t.timestamps
+    end
+
+    add_index :post_types, :name, unique: true
+  end
+end

data/lib/tasks/templates/db/migrate/create_posts.rb.tt

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+class CreatePosts < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :posts do |t|
+      t.string :title, null: false
+      t.string :slug, null: false
+<% if use_json_content? -%>
+      t.jsonb :content
+<% else -%>
+      t.text :content
+<% end -%>
+      t.references :post_type, null: false, foreign_key: true
+      t.string :status, null: false, default: "draft"
+      t.datetime :published_at
+<% if include_seo_fields? -%>
+
+      # SEO fields
+      t.string :title_tag
+      t.text :meta_description
+<% end -%>
+
+      # Metrics
+      t.integer :word_count
+
+      t.timestamps
+    end
+
+    add_index :posts, [:post_type_id, :slug], unique: true
+  end
+end

data/lib/tasks/templates/models/post.rb.tt

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class Post < ApplicationRecord
+  acts_as_bunko_post
+
+  # All standard Bunko behavior (associations, validations, scopes) is included via acts_as_bunko_post
+  # Add custom validations, associations, or methods below as needed
+end

data/lib/tasks/templates/models/post_type.rb.tt

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class PostType < ApplicationRecord
+  acts_as_bunko_post_type
+
+  # All standard Bunko behavior (associations, validations) is included via acts_as_bunko_post_type
+  # Add custom validations, associations, or methods below as needed
+end

data/lib/tasks/templates/views/collections/index.html.erb.tt

@@ -0,0 +1,67 @@
+<%%= render "shared/bunko_styles" %>
+<%%= render "shared/bunko_nav" %>
+
+<main class="container <%= collection_name %>-index">
+  <h1><%= collection_title %></h1>
+
+  <%% if @posts.any? %>
+    <div class="posts">
+      <%% @posts.each do |post| %>
+        <article class="post-preview">
+          <h2>
+            <% if is_collection %>
+            <%# Collections link to canonical PostType URLs %>
+            <%%= link_to post.title, send("#{post.post_type.name.singularize}_path", post.slug) %>
+            <% else %>
+            <%# PostTypes link to their own show page %>
+            <%%= link_to post.title, <%= path_helper %>(post.slug) %>
+            <% end %>
+          </h2>
+
+          <div class="post-meta">
+            <strong>
+                <%% if post.published_at %>
+                <time datetime="<%%= post.published_at.iso8601 %>">
+                    <%%= post.published_at.strftime("%B %d, %Y") %>
+                </time>
+                <%% end %>
+
+                <%% if post.reading_time %>
+                <span>&nbsp;•&nbsp;</span>
+                <span class="reading-time">
+                    <%%= post.reading_time %> min read
+                </span>
+                <%% end %>
+            </strong>
+          </div>
+
+          <%% if post.content.present? %>
+            <div class="post-excerpt">
+              <%%= post.excerpt(length: 200) %>
+            </div>
+          <%% end %>
+        </article>
+      <%% end %>
+    </div>
+
+    <%% if @pagination[:total_pages] > 1 %>
+      <section class="pagination" style=display: flex; justify-content: space-between;">
+        <%% if @pagination[:prev_page] %>
+          <%%= link_to "← Previous", <%= index_path_helper %>(page: @pagination[:current_page] - 1), class: "pagination-prev" %>
+        <%% end %>
+
+        <span class="pagination-info">
+          Page <%%= @pagination[:current_page] %> of <%%= @pagination[:total_pages] %>
+        </span>
+
+        <%% if @pagination[:next_page] %>
+          <%%= link_to "Next →", <%= index_path_helper %>(page: @pagination[:current_page] + 1), class: "pagination-next" %>
+        <%% end %>
+      </section>
+    <%% end %>
+  <%% else %>
+    <p class="no-posts">No <%= collection_title.downcase %> posts yet.</p>
+  <%% end %>
+</main>
+
+<%%= render "shared/bunko_footer" %>

data/lib/tasks/templates/views/collections/show.html.erb.tt

@@ -0,0 +1,39 @@
+<%%= render "shared/bunko_styles" %>
+<%%= render "shared/bunko_nav" %>
+
+<main class="container">
+  <article class="post">
+    <header class="post-header">
+      <h1><%%= @post.title %></h1>
+
+      <div class="post-meta">
+        <%% if @post.published_at %>
+          <time datetime="<%%= @post.published_at.iso8601 %>">
+            <%%= @post.published_at.strftime("%B %d, %Y") %>
+          </time>
+        <%% end %>
+
+        <%% if @post.reading_time %>
+          <span>&nbsp;•&nbsp;</span>
+          <span class="reading-time">
+            <%%= @post.reading_time %> min read
+          </span>
+        <%% end %>
+      </div>
+    </header>
+
+    <div class="post-content">
+<% if format == "html" -%>
+      <%%= sanitize(@post.content) %>
+<% else -%>
+      <%%= simple_format(@post.content) %>
+<% end -%>
+    </div>
+
+    <footer class="post-footer">
+        <%%= link_to "← Back to <%= collection_title %>", <%= index_path_helper %>, class: "back-link" %>
+    </footer>
+  </article>
+</main>
+
+<%%= render "shared/bunko_footer" %>

data/lib/tasks/templates/views/layouts/bunko_footer.html.erb.tt

@@ -0,0 +1,3 @@
+<footer class="container">
+  <small>© <%%= Date.current.year %> • Built with <a href="https://github.com/kanejamison/bunko">Bunko</a></small>
+</footer>

data/lib/tasks/templates/views/layouts/bunko_nav.html.erb.tt

@@ -0,0 +1,9 @@
+<header class="container">
+  <nav style="gap: 1rem;">
+    <%%= link_to "Home", root_path %>
+
+    <div style="display: flex; gap: 1rem; flex-wrap: wrap; justify-content: end;">
+      <%%# bunko_collection_links - additional collections will be added here unless you delete this line %>
+    </div>
+  </nav>
+</header>

data/lib/tasks/templates/views/layouts/bunko_styles.html.erb.tt

@@ -0,0 +1,3 @@
+<%%# Bunko ships our basic view files with https://picocss.com/ to give you a basic styled experience. %>
+<%%# Feel free to delete this partial and references as you add your own design. %>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">

data/lib/tasks/templates/views/pages/show.html.erb.tt

@@ -0,0 +1,16 @@
+<%%= render "shared/bunko_styles" %>
+<%%= render "shared/bunko_nav" %>
+
+<main class="container">
+  <article class="page">
+    <header class="page-header">
+      <h1><%%= @post.title %></h1>
+    </header>
+
+    <div class="page-content">
+      <%%= sanitize(@post.content) %>
+    </div>
+  </article>
+</main>
+
+<%%= render "shared/bunko_footer" %>

data/sig/bunko.rbs

@@ -0,0 +1,4 @@
+module Bunko
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: bunko
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Kane Jamison
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Bunko provides a lightweight CMS structure for Rails based on a 'one
+  model, infinite collections' philosophy. Create multiple content collections (blog,
+  docs, changelog) without duplicate code or migrations.
+email:
+- 918780+kanejamison@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".standard.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- LICENSE.txt
+- README.md
+- ROADMAP.md
+- Rakefile
+- lib/bunko.rb
+- lib/bunko/configuration.rb
+- lib/bunko/controllers.rb
+- lib/bunko/controllers/acts_as.rb
+- lib/bunko/controllers/collection.rb
+- lib/bunko/models.rb
+- lib/bunko/models/acts_as.rb
+- lib/bunko/models/post_methods.rb
+- lib/bunko/models/post_methods/publishable.rb
+- lib/bunko/models/post_methods/sluggable.rb
+- lib/bunko/models/post_methods/word_countable.rb
+- lib/bunko/models/post_type_methods.rb
+- lib/bunko/railtie.rb
+- lib/bunko/routing.rb
+- lib/bunko/routing/mapper_methods.rb
+- lib/bunko/version.rb
+- lib/tasks/bunko/add.rake
+- lib/tasks/bunko/helpers.rb
+- lib/tasks/bunko/install.rake
+- lib/tasks/bunko/sample_data.rake
+- lib/tasks/bunko/setup.rake
+- lib/tasks/support/sample_data_generator.rb
+- lib/tasks/templates/INSTALL.md
+- lib/tasks/templates/config/initializers/bunko.rb.tt
+- lib/tasks/templates/controllers/controller.rb.tt
+- lib/tasks/templates/controllers/pages_controller.rb.tt
+- lib/tasks/templates/db/migrate/create_post_types.rb.tt
+- lib/tasks/templates/db/migrate/create_posts.rb.tt
+- lib/tasks/templates/models/post.rb.tt
+- lib/tasks/templates/models/post_type.rb.tt
+- lib/tasks/templates/views/collections/index.html.erb.tt
+- lib/tasks/templates/views/collections/show.html.erb.tt
+- lib/tasks/templates/views/layouts/bunko_footer.html.erb.tt
+- lib/tasks/templates/views/layouts/bunko_nav.html.erb.tt
+- lib/tasks/templates/views/layouts/bunko_styles.html.erb.tt
+- lib/tasks/templates/views/pages/show.html.erb.tt
+- sig/bunko.rbs
+homepage: https://github.com/kanejamison/bunko
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/kanejamison/bunko
+  changelog_uri: https://github.com/kanejamison/bunko/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: A simple and lightweight content management system for Rails.
+test_files: []