kern 0.5.0

data/app/views/components/_heading.html.erb

@@ -0,0 +1,12 @@
+<%# locals: (level: :h1, breadcrumbs: [], actions: [], css: class_names("flex items-center gap-x-1 h-8 font-sans font-bold text-gray-950 *:inline-block", {"text-base font-bold tracking-tight md:text-lg": level == :h1, "text-sm font-semibold md:text-base": level == :h2, "text-xs font-medium md:text-sm": level == :h3})) %>
+<%= tag.header id: "heading", class: class_names("flex items-center justify-between", {"px-4 py-5 border-b border-gray-200/50": level == :h1}) do %>
+  <%= tag.send(level, class: css) do %>
+    <%= safe_join(breadcrumbs.map.with_index {|it, index| tag.span(link_to(it[:label], it[:href], class: "hover:underline", id: "header_part_link_#{index}") + tag.span("/", class: "ml-1 font-normal text-gray-400"), id: "header_part_#{index}")}) if level == :h1 %>
+
+    <%= breadcrumbs.present? ? tag.span(yield, class: "text-gray-500") : tag.span(yield) %>
+  <% end %>
+
+  <%= tag.ul class: "shrink-0 flex items-center gap-x-2 leading-none" do %>
+    <%= safe_join(actions.map {tag.li(it)}) %>
+  <% end if actions.any? %>
+<% end %>

data/app/views/components/flash/_message.html.erb

@@ -0,0 +1,4 @@
+<%# locals: (type:, message:, icon: "check-circle", icon_css: class_names("size-3.5 shrink-0", {"text-emerald-300": type == "notice", "text-red-400": type == "alert"}), css: class_names("flex items-center gap-x-1.5 bg-gradient-to-b from-gray-900/80 to-gray-900 px-3 py-1.5 text-xs font-normal text-white ring ring-gray-700/90 rounded-md shadow-lg transition-all")) %>
+<li class="translate-x-0 opacity-100 transition-all duration-300 ease-in-out starting:translate-x-4 starting:opacity-0">
+  <%= tag.p safe_join([(icon(icon, class: icon_css) rescue nil), message]), aria: {live: :polite}, class: css %>
+</li>

data/app/views/kern/pages/welcome.html.erb

@@ -0,0 +1,42 @@
+<main class="mt-6 px-2 max-w-5xl mx-auto">
+  <h1 class="font-sans font-bold text-gray-950 text-base tracking-tight md:text-lg">
+    Welcome to Kern
+  </h1>
+
+  <p class="mt-2 text-sm md:text-base text-gray-800">
+    SaaS foundation for Ruby on Rails apps by <%= link_to "Rails Designer", "https://railsdesigner.com" %>. You are ready to build your next SaaS.
+  </p>
+
+  <section class="mt-6">
+    <h2 class="font-sans font-bold text-gray-950 text-sm tracking-tight md:text-base">
+      Get started
+    </h2>
+
+    <ul class="list-disc list-inside marker:text-blue-500">
+      <li>
+        add your own root route (<code>root to: "dashboard#show"</code>)
+      </li>
+
+      <li>
+        install <%= link_to "Rails Icons", "https://github.com/Rails-Designer/rails_icons" %>; Kern uses the <b>Phosphor</b> library
+      </li>
+
+      <li>
+        override any views by running <code>bin/rails g kern:views</code>
+      </li>
+
+      <li>
+        override any feature by running <code>bin/rals g kern:feature</code>
+      </li>
+
+      <li>
+        build your SaaS
+      </li>
+
+      <li>
+        profit 🤑
+      </li>
+    </ul>
+
+  </section>
+</main>

data/app/views/kern/passwords/edit.html.erb

@@ -0,0 +1,12 @@
+<% content_for :title, "Update password" %>
+<% content_for :page_title, "Update account password" %>
+
+<%= form_with url: password_path(params[:token]), method: :put, class: "px-2 pb-2 md:px-4 md:pb-4" do |form| %>
+  <%= form.input :password, required: true, autocomplete: "new-password", placeholder: "Enter new password", maxlength: 72 %>
+
+  <%= form.input :password_confirmation, required: true, autocomplete: "new-password", placeholder: "Repeat new password", maxlength: 72 %>
+
+  <div class="buttons">
+    <%= form.submit "Save", class: "btn-primary" %>
+  </div>
+<% end %>

data/app/views/kern/passwords/new.html.erb

@@ -0,0 +1,10 @@
+<% content_for :title, "Reset your password" %>
+<% content_for :page_title, "Reset your password" %>
+
+<%= form_with url: passwords_path, class: "px-2 pb-2 md:px-4 md:pb-4" do |form| %>
+  <%= form.input :email_address, required: true, autofocus: true, autocomplete: "username", placeholder: "Enter your email address", value: params[:email_address] %>
+
+  <div class="buttons">
+    <%= form.submit "Continue", class: "btn-primary" %>
+  </div>
+<% end %>

data/app/views/kern/passwords_mailer/reset.html.erb

@@ -0,0 +1,6 @@
+<p>
+  You can reset your password on
+  <%= link_to "this password reset page", kern.edit_password_url(@user.password_reset_token) %>.
+
+  This link will expire in <%= distance_of_time_in_words(0, @user.password_reset_token_expires_in) %>.
+</p>

data/app/views/kern/passwords_mailer/reset.html.erb.tt

@@ -0,0 +1,6 @@
+<p>
+  You can reset your password on
+  <%%= link_to "this password reset page", edit_password_url(@user.password_reset_token) %>.
+
+  This link will expire in <%%= distance_of_time_in_words(0, @user.password_reset_token_expires_in) %>.
+</p>

data/app/views/kern/passwords_mailer/reset.text.erb

@@ -0,0 +1,4 @@
+You can reset your password on
+<%= kern.edit_password_url(@user.password_reset_token) %>
+
+This link will expire in <%= distance_of_time_in_words(0, @user.password_reset_token_expires_in) %>.

data/app/views/kern/passwords_mailer/reset.text.erb.tt

@@ -0,0 +1,4 @@
+You can reset your password on
+<%%= edit_password_url(@user.password_reset_token) %>
+
+This link will expire in <%%= distance_of_time_in_words(0, @user.password_reset_token_expires_in) %>.

data/app/views/kern/sessions/new.html.erb

@@ -0,0 +1,16 @@
+<% content_for :title, "Log in" %>
+<% content_for :page_title, "Log in" %>
+
+<%= form_with url: session_path, class: "px-2 md:px-4" do |form| %>
+  <%= form.input :email_address, type: :email, required: true, autofocus: true, autocomplete: "username", value: params[:email_address] %>
+
+  <%= form.input :password, required: true, autocomplete: "current-password", maxlength: 72, label_suffix: link_to("Forgot password?", new_password_path, class: "font-normal text-gray-400 hover:text-gray-500") %>
+
+  <div class="buttons">
+    <%= form.submit "Log in", data: {turbo_submits_with: "Logging in…"}, class: "btn-primary" %>
+  </div>
+<% end %>
+
+<p class="px-2 pt-4 pb-2 border-t border-gray-100 md:pb-4">
+  <%= link_to "No account yet?", new_signup_path, class: "block text-center text-sm text-gray-500 hover:underline" %>
+</p>

data/app/views/kern/settings/_cards.html.erb

@@ -0,0 +1,10 @@
+<%# locals: (card_css: "col-span-12 md:col-span-4 lg:col-span-3", link_css: "block px-3 py-2 border border-gray-100 rounded-md transition ease-in-out delay-75 hover:border-gray-200 hover:shadow-lg/5", heading_css: "text-base font-bold tracking-tight text-gray-800", description_css: "mt-0.5 text-sm font-light text-gray-600") %>
+<ul class="grid grid-cols-12">
+  <%= tag.li class: card_css do %>
+    <%= link_to settings_user_path, class: link_css do %>
+      <%= tag.h4 "Account", class: heading_css %>
+
+      <%= tag.p "Update your email and password", class: description_css %>
+    <% end %>
+  <% end %>
+</ul>

data/app/views/kern/settings/show.html.erb

@@ -0,0 +1,5 @@
+<% content_for :title, "Settings" %>
+
+<%= component("heading") { "Settings" } %>
+
+<%= component("container") { render "kern/settings/cards" } %>

data/app/views/kern/settings/users/show.html.erb

@@ -0,0 +1,15 @@
+<% content_for :title, "Account" %>
+
+<%= component("heading", breadcrumbs: [{label: "Settings", href: settings_path}]) { "Account" } %>
+
+<%= component "container" do %>
+  <%= form_with model: [:settings, @user], class: "max-w-lg" do |form| %>
+    <%= form.input :email_address %>
+
+    <%= form.input :password %>
+
+    <div class="buttons">
+      <%= form.submit "Save", class: "btn-primary" %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/kern/signups/new.html.erb

@@ -0,0 +1,16 @@
+<% content_for :title, "Create your account" %>
+<% content_for :page_title, "Create your account" %>
+
+<%= form_with model: @signup, url: signup_path, class: "px-2 md:px-4" do |form| %>
+  <%= form.input :email_address %>
+
+  <%= form.input :password %>
+
+  <div class="buttons">
+    <%= form.submit "Sign up", data: {turbo_submits_with: "Signing up…"}, class: "btn-primary" %>
+  </div>
+<% end %>
+
+<p class="px-2 pt-4 pb-2 border-t border-gray-100 md:pb-4">
+  <%= link_to "Already have an account?", new_session_path, class: "block text-center text-sm font-medium text-gray-500 hover:underline" %>
+</p>

data/app/views/layouts/kern/application/_navigation.html.erb

@@ -0,0 +1,30 @@
+<%# locals: (links: [], link_css: "group/link flex items-center gap-x-2 px-3 py-2 rounded-md hover:bg-gray-200/40") %>
+<nav class="w-16 shrink-0 px-2 bg-gray-50 border-r border-gray-100 lg:px-6 lg:w-60">
+  <div class="sticky top-0 h-dvh pb-4 flex flex-col justify-between">
+    <div class="mt-7">
+      <header class="flex items-center gap-x-1.5 px-3">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor" class="size-4.5 shrink-0 fill-brand-400 text-brand-600"><path d="M223.85,47.12a16,16,0,0,0-15-15c-12.58-.75-44.73.4-71.41,27.07L132.69,64H74.36A15.91,15.91,0,0,0,63,68.68L28.7,103a16,16,0,0,0,9.07,27.16l38.47,5.37,44.21,44.21,5.37,38.49a15.94,15.94,0,0,0,10.78,12.92,16.11,16.11,0,0,0,5.1.83A15.91,15.91,0,0,0,153,227.3L187.32,193A15.91,15.91,0,0,0,192,181.64V123.31l4.77-4.77C223.45,91.86,224.6,59.71,223.85,47.12ZM74.36,80h42.33L77.16,119.52,40,114.34Zm74.41-9.45a76.65,76.65,0,0,1,59.11-22.47,76.46,76.46,0,0,1-22.42,59.16L128,164.68,91.32,128ZM176,181.64,141.67,216l-5.19-37.17L176,139.31Zm-74.16,9.5C97.34,201,82.29,224,40,224a8,8,0,0,1-8-8c0-42.29,23-57.34,32.86-61.85a8,8,0,0,1,6.64,14.56c-6.43,2.93-20.62,12.36-23.12,38.91,26.55-2.5,36-16.69,38.91-23.12a8,8,0,1,1,14.56,6.64Z"/></svg>
+
+        <%= tag.small Rails.application.name.humanize, class: "sr-only text-sm font-extrabold tracking-tight text-slate-800 lg:not-sr-only" %>
+      </header>
+
+      <ul class="flex flex-col mt-8 gap-y-0.5">
+        <% links.each do |link| %>
+          <li>
+            <%= link_to link[:href], class: class_names(link_css, {"bg-gray-200/40": current_page?(link[:href])}) do %>
+              <%= icon link[:icon], variant: :duotone, class: class_names("size-4 shrink-0 text-current group-hover/link:text-brand-700 group-hover/link:fill-brand-700", {"text-gray-700 fill-brand-600/60": current_page?(link[:href])}) rescue nil %>
+
+              <%= tag.span link[:label], class: "sr-only text-sm font-medium text-gray-800 group-hover/link:text-brand-950 lg:not-sr-only" %>
+            <% end %>
+          </li>
+        <% end %>
+      </ul>
+    </div>
+
+    <%= link_to kern.settings_path, class: link_css do %>
+      <%= icon "gear-six", variant: :duotone, class: "size-4 shrink-0 text-current group-hover/link:text-brand-700 group-hover/link:fill-brand-700" rescue nil %>
+
+      <span class="sr-only shrink-0 text-sm font-medium text-gray-800 group-hover/link:text-gray-950 lg:not-sr-only">Settings</span>
+    <% end %>
+  </div>
+</nav>

data/app/views/layouts/kern/application.html.erb

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>
+      <%= content_for?(:title)? "#{yield(:title)} - #{Rails.application.name.humanize}" : Rails.application.name.humanize %>
+    </title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <%= stylesheet_link_tag :tailwind, "data-turbo-track": "reload" %>
+  </head>
+
+  <body class="<%= class_names("antialiased bg-white selection:bg-pink-200/40 selection:text-pink-800/70", yield(:body_class)) %>">
+    <div class="flex">
+      <%= render partial: "layouts/kern/application/navigation",
+        locals: {
+          links: [
+            {label: "Home", href: main_app.respond_to?(:root_path) ? main_app.root_path : root_path, icon: "house-line"},
+          ]
+        }
+      %>
+
+      <div class="flex-1">
+        <%= yield %>
+      </div>
+    </div>
+
+    <%= component "flash" %>
+  </body>
+</html>

data/app/views/layouts/kern/application.html.erb.tt

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>
+      <%%= content_for?(:title)? "#{yield(:title)} - #{Rails.application.name.humanize}" : Rails.application.name.humanize %>
+    </title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <%%= csrf_meta_tags %>
+    <%%= csp_meta_tag %>
+
+    <%%= stylesheet_link_tag :tailwind, "data-turbo-track": "reload" %>
+  </head>
+
+  <body class="<%%= class_names("antialiased bg-white selection:bg-pink-200/40 selection:text-pink-800/70", yield(:body_class)) %>">
+    <div class="flex">
+      <%%= render partial: "layouts/kern/application/navigation",
+        locals: {
+          links: [
+            {label: "Home", href: root_path, icon: "house-line"},
+          ]
+        }
+      %>
+
+      <div class="flex-1">
+        <%%= yield %>
+      </div>
+    </div>
+
+    <%%= component "flash" %>
+  </body>
+</html>

data/app/views/layouts/kern/auth.html.erb

@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>
+      <%= content_for?(:title)? "#{yield(:title)} - #{Rails.application.name.humanize}" : Rails.application.name.humanize %>
+    </title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <meta name="robots" content="noindex, nofollow">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <%= stylesheet_link_tag :tailwind, "data-turbo-track": "reload" %>
+  </head>
+
+  <body class="relative antialiased overflow-clip">
+    <svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="absolute -top-[400px] -left-[350px] size-[800px] text-brand-500">
+      <path fill="currentColor" d="M42.9,-43.4C60.9,-36,84.8,-27.6,92.2,-12.2C99.8,3.1,91.2,25.4,76.1,37C61.1,48.5,39.7,49.3,21.9,52.7C4,56.1,-10.4,62,-26.6,61.1C-42.9,60.3,-61.1,52.9,-61.9,41C-62.6,28.8,-46,12.1,-42.2,-7C-38.4,-25.9,-47.4,-46.5,-42.5,-56.1C-37.6,-65.8,-18.8,-64.5,-3.2,-60.7C12.4,-57,24.9,-50.8,42.9,-43.4Z" transform="translate(100 100)" />
+    </svg>
+
+    <svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="absolute -bottom-[450px] -right-[300px] size-[800px] rotate-32 text-cyan-400">
+      <path fill="currentColor" d="M42.9,-43.4C60.9,-36,84.8,-27.6,92.2,-12.2C99.8,3.1,91.2,25.4,76.1,37C61.1,48.5,39.7,49.3,21.9,52.7C4,56.1,-10.4,62,-26.6,61.1C-42.9,60.3,-61.1,52.9,-61.9,41C-62.6,28.8,-46,12.1,-42.2,-7C-38.4,-25.9,-47.4,-46.5,-42.5,-56.1C-37.6,-65.8,-18.8,-64.5,-3.2,-60.7C12.4,-57,24.9,-50.8,42.9,-43.4Z" transform="translate(100 100)" />
+    </svg>
+
+    <main class="grid place-items-center h-screen">
+      <div class="w-full max-w-xl">
+        <%= link_to Config::Urls.site, class: "flex justify-center items-center size-6 mx-auto text-brand-500 rounded-full transition ease-in-out hover:text-brand-800 hover:bg-brand-50 hover:scale-105" do %>
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor" class="size-5 shrink-0 fill-brand-400"><path d="M223.85,47.12a16,16,0,0,0-15-15c-12.58-.75-44.73.4-71.41,27.07L132.69,64H74.36A15.91,15.91,0,0,0,63,68.68L28.7,103a16,16,0,0,0,9.07,27.16l38.47,5.37,44.21,44.21,5.37,38.49a15.94,15.94,0,0,0,10.78,12.92,16.11,16.11,0,0,0,5.1.83A15.91,15.91,0,0,0,153,227.3L187.32,193A15.91,15.91,0,0,0,192,181.64V123.31l4.77-4.77C223.45,91.86,224.6,59.71,223.85,47.12ZM74.36,80h42.33L77.16,119.52,40,114.34Zm74.41-9.45a76.65,76.65,0,0,1,59.11-22.47,76.46,76.46,0,0,1-22.42,59.16L128,164.68,91.32,128ZM176,181.64,141.67,216l-5.19-37.17L176,139.31Zm-74.16,9.5C97.34,201,82.29,224,40,224a8,8,0,0,1-8-8c0-42.29,23-57.34,32.86-61.85a8,8,0,0,1,6.64,14.56c-6.43,2.93-20.62,12.36-23.12,38.91,26.55-2.5,36-16.69,38.91-23.12a8,8,0,1,1,14.56,6.64Z"/></svg>
+        <% end %>
+
+        <div class="w-full mt-6 p-2 ring ring-gray-200/50 bg-white/50 backdrop-blur-md md:rounded-xl md:shadow-lg">
+          <section class="flex flex-col gap-y-5 bg-white ring-gray-200/60 md:ring md:rounded-md md:shadow-lg">
+            <%= tag.h1 yield(:page_title), class: "mx-2 mt-8 font-sans text-center text-base font-bold text-gray-800 md:mx-4" %>
+
+            <%= yield %>
+          </section>
+        </div>
+      </div>
+    </main>
+
+    <%= component "flash" %>
+  </body>
+</html>

data/bin/dev

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+cd test/dummy
+exec bin/dev "$@"

data/bin/rails

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails gems
+# installed from the root of your application.
+
+ENGINE_ROOT = File.expand_path("..", __dir__)
+ENGINE_PATH = File.expand_path("../lib/kern/engine", __dir__)
+APP_PATH = File.expand_path("../test/dummy/config/application", __dir__)
+
+# Set up gems listed in the Gemfile.
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+require "bundler/setup" if File.exist?(ENV["BUNDLE_GEMFILE"])
+
+require "rails/all"
+require "rails/engine/commands"

data/bin/release

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+VERSION=$1
+
+if [ -z "$VERSION" ]; then
+  echo "Error: Version number or bump type is required."
+  echo "Usage: $0 <major|minor|patch|version-number>"
+
+  exit 1
+fi
+
+# If `VERSION` is a keyword, bump the current version
+if [[ "$VERSION" =~ ^(major|minor|patch)$ ]]; then
+  CURRENT=$(grep -oP 'VERSION = "\K[^"]+' ./lib/kern/version.rb)
+  IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+  case $VERSION in
+    major) VERSION="$((MAJOR + 1)).0.0" ;;
+    minor) VERSION="$MAJOR.$((MINOR + 1)).0" ;;
+    patch) VERSION="$MAJOR.$MINOR.$((PATCH + 1))" ;;
+  esac
+fi
+
+printf "module Kern\n  VERSION = \"$VERSION\"\nend\n" > ./lib/kern/version.rb
+
+bundle
+
+git add Gemfile.lock lib/kern/version.rb
+git commit -m "Bump version for $VERSION"
+git push
+git tag v$VERSION
+git push --tags
+
+rake build
+gem push "pkg/kern-$VERSION.gem"

data/config/routes.rb

@@ -0,0 +1,13 @@
+Kern::Engine.routes.draw do
+  resource :settings, only: %w[show]
+  namespace :settings do
+    resource :user, path: "account", only: %w[show update]
+  end
+
+  resource :signup, only: %w[new create]
+
+  resource :session, only: %w[new create destroy]
+  resources :passwords, param: :token, only: %w[new create edit update]
+
+  root to: "pages#welcome" unless Rails.application.routes.named_routes.key?(:root)
+end

data/db/migrate/20250101000001_create_users.rb

@@ -0,0 +1,13 @@
+class CreateUsers < ActiveRecord::Migration[8.0]
+  def change
+    create_table :users do |t|
+      t.string :email_address, null: false
+      t.string :password_digest, null: false
+      t.integer :current_workspace_id, null: true
+
+      t.timestamps
+    end
+
+    add_index :users, :email_address, unique: true
+  end
+end

data/db/migrate/20250101000002_create_sessions.rb

@@ -0,0 +1,11 @@
+class CreateSessions < ActiveRecord::Migration[8.0]
+  def change
+    create_table :sessions do |t|
+      t.references :user, null: false, foreign_key: true
+      t.string :ip_address, null: false
+      t.string :user_agent, null: false
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20250101000003_create_workspaces.rb

@@ -0,0 +1,12 @@
+class CreateWorkspaces < ActiveRecord::Migration[7.0]
+  def change
+    create_table :workspaces do |t|
+      t.string :slug, null: false
+      t.text :name, null: false
+
+      t.timestamps
+    end
+
+    add_index :workspaces, :slug, unique: true
+  end
+end

data/db/migrate/20250101000004_create_members.rb

@@ -0,0 +1,15 @@
+class CreateMembers < ActiveRecord::Migration[7.0]
+  def change
+    create_table :members do |t|
+      t.belongs_to :user, null: false, foreign_key: true
+      t.belongs_to :workspace, null: false, foreign_key: true
+      t.string :slug, null: false
+      t.datetime :deleted_at, null: true
+
+      t.timestamps
+    end
+
+    add_index :members, [:slug, :workspace_id], unique: true
+    add_index :members, :deleted_at, using: :brin
+  end
+end

data/db/migrate/20250101000005_create_roles.rb

@@ -0,0 +1,11 @@
+class CreateRoles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :roles do |t|
+      t.string :name, null: false
+
+      t.timestamps
+    end
+
+    add_index :roles, :name, unique: true
+  end
+end

data/db/migrate/20250101000006_create_actors.rb

@@ -0,0 +1,10 @@
+class CreateActors < ActiveRecord::Migration[8.1]
+  def change
+    create_table :actors do |t|
+      t.belongs_to :member, null: false, foreign_key: true
+      t.belongs_to :role, null: false, foreign_key: true
+
+      t.timestamps
+    end
+  end
+end

data/kern.gemspec

@@ -0,0 +1,22 @@
+require_relative "lib/kern/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "kern"
+  spec.version = Kern::VERSION
+  spec.authors = ["Rails Designer"]
+  spec.email = "devs@railsdeigner.com"
+
+  spec.summary = "Rails engine with auth, billing, and common components for SaaS apps"
+  spec.description = "A Rails engine that handles the SaaS essentials: authentication, team invitations, subscription/billing, and common partials. Skip the boilerplate and start shipping the actual product. Launch faster."
+  spec.homepage = "https://saas.railsdesigner.com/"
+  spec.license = "MIT"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/Rails-Designer/kern/"
+
+  spec.files = Dir["{bin,app,db,config,lib}/**/*", "Rakefile", "README.md", "kern.gemspec", "Gemfile", "Gemfile.lock"]
+
+  spec.required_ruby_version = ">= 3.4.0"
+
+  spec.add_dependency "rails", ">= 8.0.0"
+end

data/lib/generators/kern/feature/USAGE

@@ -0,0 +1,17 @@
+Description:
+  Generates Kern foundational components (models, controllers, views and routes).
+
+Example:
+  rails generate kern:feature sessions
+
+  This will generate the sessions feature with model, controller, views and routes.
+
+  rails generate kern:feature sessions passwords
+
+  This will generate sessions and passwords features.
+
+Available features:
+  passwords   Password reset functionality
+  sessions    User authentication (sign in/out)
+  settings    User settings (user, workspace settings and subscription/billing)
+  signups     User registration

data/lib/generators/kern/feature/feature_generator.rb

@@ -0,0 +1,77 @@
+module Kern
+  class FeatureGenerator < Rails::Generators::Base
+    source_root File.expand_path("../../../../../", __FILE__)
+
+    AVAILABLE_FEATURES = %w[passwords sessions settings signups]
+
+    argument :features, type: :array, required: true, banner: "feature feature"
+
+    def copy_features
+      features.each do |feature|
+        verify_exists!(feature)
+
+        case feature
+        when "sessions"
+          generate_sessions
+        when "signups"
+          generate_signups
+        when "passwords"
+          generate_passwords
+        when "settings"
+          generate_settings
+        end
+      end
+    end
+
+    private
+
+    def verify_exists!(feature)
+      return if AVAILABLE_FEATURES.include?(feature)
+
+      say "Feature `#{feature}` not found. Available features: #{AVAILABLE_FEATURES.join(", ")}", :red
+
+      exit(1)
+    end
+
+    def generate_sessions
+      directory "app/models", "app/models"
+      template "app/controllers/concerns/authentication.rb.tt", "app/controllers/concerns/authentication.rb"
+      copy_file "app/controllers/kern/sessions_controller.rb", "app/controllers/sessions_controller.rb"
+      directory "app/views/kern/sessions", "app/views/sessions"
+
+      route "resource :session, only: %w[new create destroy]"
+    end
+
+    def generate_signups
+      directory "app/models", "app/models" unless features.include?("sessions")
+
+      template "app/controllers/kern/signups_controller.rb.tt", "app/controllers/signups_controller.rb"
+      directory "app/views/kern/signups", "app/views/signups"
+
+      route "resource :signup, only: %w[new create]"
+    end
+
+    def generate_passwords
+      directory "app/views/kern/passwords", "app/views/passwords"
+      copy_file "app/controllers/kern/passwords_controller.rb", "app/controllers/passwords_controller.rb"
+      copy_file "app/mailers/kern/passwords_mailer.rb", "app/mailers/passwords_mailer.rb"
+      template "app/views/kern/passwords_mailer/reset.text.erb.tt", "app/views/passwords_mailer/reset.text.erb"
+      template "app/views/kern/passwords_mailer/reset.html.erb.tt", "app/views/passwords_mailer/reset.html.erb"
+
+      route "resources :passwords, param: :token, only: %w[new create edit update]"
+    end
+
+    def generate_settings
+      directory "app/views/kern/settings", "app/views/settings"
+      copy_file "app/controllers/kern/settings_controller.rb", "app/controllers/settings_controller.rb"
+      directory "app/controllers/kern/settings", "app/controllers/settings"
+
+      route <<~RUBY
+        resource :settings, only: %w[show]
+        namespace :settings do
+          resource :user, path: "account", only: %w[show update]
+        end
+      RUBY
+    end
+  end
+end

data/lib/generators/kern/helpers.rb

@@ -0,0 +1,28 @@
+module Kern
+  module Helpers
+    def bundle_command(command, env = {}, params = {})
+      say_status :run, "bundle #{command}"
+
+      # taken from railties/lib/rails/generators/bundle_helper.rb
+      bundle_command = Gem.bin_path("bundler", "bundle")
+
+      require "bundler"
+
+      Bundler.with_original_env do
+        exec_bundle_command(bundle_command, command, env, params)
+      end
+    end
+
+    private
+
+    def exec_bundle_command(bundle_command, command, env, params)
+      full_command = %("#{Gem.ruby}" "#{bundle_command}" #{command})
+
+      if options[:quiet] || params[:quiet]
+        system(env, full_command, out: File::NULL)
+      else
+        system(env, full_command)
+      end
+    end
+  end
+end

data/lib/generators/kern/install/USAGE

@@ -0,0 +1,13 @@
+Description:
+  Installs Kern into your Rails application.
+
+Example:
+  rails generate kern:install
+
+  This will:
+    - Run Kern migrations
+    - Inject Authentication concern into ApplicationController
+    - Set Kern layout in ApplicationController
+    - Install Rails Icons (optional)
+    - Copy configuration files
+    - Mount Kern engine routes