staples 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e71f9de435ab26acdd3fb0b8f0a3c7959a9f24e70c4eac86f5c93ff6b35938d
-  data.tar.gz: d823d8bbdf8a72af9730f05522c55dfeafb5f7b07b6cdebe987d7eb8b4024e8e
+  metadata.gz: dfe4fb58be2f6637bc0d7fe688af62488a5ac8e28e4bd8a9cf85285d9d164890
+  data.tar.gz: e92a8ca1af2d5f8a20793abc37671b8312d4bb59d99ae1b8b3e84ef7402e74ce
 SHA512:
-  metadata.gz: 4167ff970e9d52419d9900bc15f354000f86de287f37463813ad7baf0ec0ef5beb53497dbf659d82176ea37b77921319ba94eb9443f7b00cad131b1e0fd919c2
-  data.tar.gz: 577e9181e26f66b5186ac377707d903f93598155a8c0cc23117e66813b9eec62d282952c6e93209975a8defb404e191fb61f26ef4bb1015ad5bd966e1a7cc7fe
+  metadata.gz: 7b1f44b2c626fa2690c1ed5c82938be6eb5f9de471286d5e31b5296c1be79bbdbf037f5e3de71390c11aaa6569319ed626533bbf359ecc5ee1092d6941b7f9c4
+  data.tar.gz: 6a459a6d9c411eb28c42c83f9312925996e34b4dbb56fdfe4bef60474a030bb724817dfb06d838c4493627d1c53dd81087eb6d8cc8a1b709a0be416840f78362

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-11-23
+## [1.0.0] - 2025-11-26
+
+### Added
+
+- YARD documentation comments for all public APIs
+- Application template that sets up a new Rails application with sensible defaults
+
+## [0.1.0] - 2025-11-25
 
 - Initial release

data/README.md

@@ -1,35 +1,255 @@
 # Staples
 
+[![Ruby](https://github.com/stevepolitodesign/staples/actions/workflows/main.yml/badge.svg)](https://github.com/stevepolitodesign/staples/actions/workflows/main.yml)
+
 The basic ingredients for your next Rails project.
 
+## Why Staples?
+
+Templates like [JumpStart][jumpstart] or [Bullet Train][bullettrain] are intended to be used for rapidly building SaaS applications.
+
+Staples makes no assumptions about your project. Instead, it's intended to be a starting off point for any and all new projects.
+
+[jumpstart]: https://jumpstartrails.com
+[bullettrain]: https://bullettrain.co
+
 ## Installation
 
 Install the gem by executing:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+gem install staples
 ```
 
+## Requirements
+
+Staples requires the latest version of [Rails][rails] and its dependencies.
+
+Additionally, Staples requires [yarn][yarn], [PostgreSQL][postgresql] and
+[Redis][redis].
+
+[rails]: https://guides.rubyonrails.org/install_ruby_on_rails.html
+[yarn]: https://yarnpkg.com/getting-started/install
+[postgresql]: https://formulae.brew.sh/formula/postgresql@17
+[redis]: https://formulae.brew.sh/formula/redis
+
 ## Usage
 
 ```
 staples <app_name>
 ```
 
+## Environment Variables
+
+Staples configures your application to use the following environment variables in production:
+
+- `DATABASE_URL` - PostgreSQL database connection string (required)
+- `APPLICATION_HOST` - The domain where your application is hosted (required, used for mailer URL generation)
+- `ASSET_HOST` - CDN or asset host URL (optional, for serving static assets)
+- `MAILER_SENDER` - Default email address for outgoing emails (defaults to `contact@example.com`)
+- `RAILS_MASTER_KEY` - Required for decrypting credentials (automatically set in CI)
+
+## Deploying to Heroku
+
+Staples is optimized for Heroku. As such, you'll want to be sure to add the required buildpacks, addons and environment variables.
+
+```
+heroku apps:create
+
+heroku buildpacks:set heroku/nodejs
+heroku buildpacks:set heroku/ruby
+
+heroku addons:create heroku-postgresql:essential-0
+heroku addons:create heroku-redis:mini
+heroku config:set \
+  APPLICATION_HOST=value-from-heroku
+  RAILS_MASTER_KEY=value-from-config/master.key
+```
+
+## GitHub Actions
+
+Because Staples sets `config.require_master_key = true`, you'll need to set this value in GitHub in order for GitHub Actions to work.
+
+```
+gh variable set RAILS_MASTER_KEY < config/master.key
+```
+
+## Features
+
+### Authentication
+
+Staples ships with a `user` model via [Devise][devise]. We prefer Devise over the [authentication generator][auth-generator] because...
+
+- It receives frequent security updates, whereas you're on your own with a generator.
+- It's widely adopted in the Rails community.
+- It has a [rich ecosystem][ecosystem].
+
+Additionally, the following modules are enabled:
+
+- [Database Authenticatable][database-authenticatable]
+- [Registerable][registerable]
+- [Recoverable][recoverable]
+- [Rememberable][rememberable]
+- [Validatable][validatable]
+- [Trackable][trackable]
+
+[database-authenticatable]: https://www.rubydoc.info/gems/devise/Devise/Models/DatabaseAuthenticatable
+[registerable]: https://www.rubydoc.info/gems/devise/Devise/Models/Registerable
+[recoverable]: https://www.rubydoc.info/gems/devise/Devise/Models/Recoverable
+[rememberable]: https://www.rubydoc.info/gems/devise/Devise/Models/Rememberable
+[validatable]: https://www.rubydoc.info/gems/devise/Devise/Models/Validatable
+[trackable]: https://www.rubydoc.info/gems/devise/Devise/Models/Trackable
+[devise]: https://github.com/heartcombo/devise
+[auth-generator]: https://guides.rubyonrails.org/security.html#authentication
+[ecosystem]: https://github.com/heartcombo/devise?tab=readme-ov-file#extensions
+
+### Organizations
+
+Staples draws inspiration from [Laravel][laravel], [JumpStart][jumpstart], and [Bullet Train][bullettrain] by introducing the concept of "Teams" in an effort to make your application more resilient from day 0.
+
+When a `user` is created, we automatically create an `organization`, and associate the two via a `membership`.
+
+[laravel]: https://jetstream.laravel.com/features/teams.html
+[jumpstart]: https://jumpstartrails.com/docs/accounts
+[bullettrain]: https://blog.bullettrain.co/teams-should-be-an-mvp-feature/
+
+### Frontend
+
+Staples proudly ships with [Bootstrap][bootstrap] as its frontend toolkit.
+
+Bootstrap is mature, battle tested, and well documented. It's basically the Rails of frontend toolkits for server-rendered applications. It gives you everything you need, (including a rich set of [JavaScript plugins][bootstrap-js]), and is [meant to be customized][bootstrap-customize].
+
+[bootstrap]: https://getbootstrap.com
+[bootstrap-js]: https://getbootstrap.com/docs/5.3/getting-started/javascript/
+[bootstrap-customize]: https://getbootstrap.com/docs/5.3/customize/overview/
+
+### Background Jobs
+
+Staples ships with [Sidekiq][sidekiq] instead of [Solid Queue][solid-queue] simply because there's an [open issue][solid-queue-issue] with Solid Queue and Heroku.
+
+[sidekiq]: https://github.com/sidekiq/sidekiq
+[solid-queue]: https://github.com/rails/solid_queue/
+[solid-queue-issue]: https://github.com/rails/solid_queue/issues/330
+
+### Configuration
+
+#### Application
+
+The following configurations are applied to all environments:
+
+- `config.active_job.queue_adapter = :sidekiq` - Uses Sidekiq for background job processing
+- `config.active_record.strict_loading_by_default = true` - Enables strict loading to prevent N+1 queries
+- `config.active_record.strict_loading_mode = :n_plus_one_only` - Strict loading only raises errors for N+1 queries
+- `config.require_master_key = true` - Requires the master key to be present for encrypted credentials
+
+#### Production
+
+- `config.sandbox_by_default = true` - Database sessions are sandboxed by default in console
+- `config.active_record.action_on_strict_loading_violation = :log` - Logs strict loading violations instead of raising errors
+- `config.asset_host = ENV["ASSET_HOST"]` - Configures asset host from environment variable
+- `config.action_mailer.default_url_options = { host: ENV.fetch("APPLICATION_HOST") }` - Sets mailer host from environment variable
+
+#### Development
+
+- `config.active_model.i18n_customize_full_message = true` - Customizes full error messages for internationalization
+- `config.i18n.raise_on_missing_translations = true` - Raises errors when translations are missing
+- `config.generators.apply_rubocop_autocorrect_after_generate! = true` - Automatically runs RuboCop autocorrect after generating files
+
+#### Test
+
+- `config.action_dispatch.show_exceptions = :none` - Disables exception pages to allow errors to propagate in tests
+- `config.action_mailer.default_url_options = { host: "localhost", port: 3001 }` - Sets mailer host for test environment
+- `config.i18n.raise_on_missing_translations = true` - Raises errors when translations are missing
+- `config.active_job.queue_adapter = :inline` - Executes background jobs synchronously in tests
+
+### Views
+
+Staples includes several view enhancements.
+
+#### Application Layout
+
+The HTML tag includes a `lang` attribute set to the current locale (`<html lang="<%= I18n.locale %>">`), which improves accessibility and SEO.
+
+#### Partials
+
+Staples provides reusable partials to handle common UI patterns:
+
+- **Flash messages** (`app/views/application/_flashes.html.erb`) - Displays Bootstrap-styled flash messages for notices, alerts, and other feedback
+- **Form error messages** (`app/views/application/_error_messages.html.erb`) - Consistently displays validation errors across forms
+- **Navigation** (`app/views/application/_nav.html.erb`) - A Bootstrap navbar with authentication-aware links
+- **Card component** (`app/views/application/_card.html.erb`) - A reusable card component for consistent layout
+
+#### Devise Views
+
+Custom Devise views are included for all authentication flows (sign up, sign in, password recovery, account editing) with Bootstrap styling applied.
+
+### Test Suite
+
+Staples includes a comprehensive test suite built on Rails' default testing framework with additional tools for better test coverage and maintainability.
+
+#### Testing Gems
+
+The following gems are included to enhance the testing experience:
+
+- [Factory Bot][factory-bot] - Provides factories for test data instead of fixtures
+- [Capybara Email][capybara-email] - Adds email testing capabilities to system tests
+- [Capybara Accessibility Audit][capybara-accessibility] - Automatically audits accessibility in system tests
+
+[factory-bot]: https://github.com/thoughtbot/factory_bot_rails
+[capybara-email]: https://github.com/dockyard/capybara-email
+[capybara-accessibility]: https://github.com/thoughtbot/capybara_accessibility_audit
+
+#### Test Helpers
+
+Staples configures the test suite with helpful integrations:
+
+- Devise test helpers are included in all tests via `Devise::Test::IntegrationHelpers`
+- Factory Bot syntax methods are available throughout the test suite
+- Capybara is configured to run on port 3001 in order to work with Capybara Email.
+- A `sign_in_as(user)` helper method is added to `ApplicationSystemTestCase` for easy authentication in system tests
+
+#### Included Tests
+
+The following test files are generated to provide examples and coverage for core functionality:
+
+- Model tests for `User`, `Organization`, and `Membership`
+- Controller tests for Devise registrations
+- System tests for authentication flows
+- Factory definitions for all core models
+
+### Strong Migrations
+
+Staples ships with [Strong Migrations][strong-migrations] in order to catch unsafe migrations in development.
+
+[strong-migrations]: https://github.com/ankane/strong_migrations
+
+### Static Pages
+
+Staples ships with [High Voltage][high-voltage] to easily include static pages.
+
+[high-voltage]: https://github.com/thoughtbot/high_voltage
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. From there, you can run `staples <app_name>` to test the current code.
+
+To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org][rubygems].
+
+[rubygems]: https://rubygems.org
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/stevepolitodesign/staples. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/stevepolitodesign/staples/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/stevepolitodesign/staples. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct][coc].
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License][mit].
 
 ## Code of Conduct
 
-Everyone interacting in the Staples project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/stevepolitodesign/staples/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Staples project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct][coc].
+
+[coc]: https://github.com/stevepolitodesign/staples/blob/main/CODE_OF_CONDUCT.md
+[mit]: https://opensource.org/licenses/MIT

data/lib/staples/cli.rb

@@ -1,21 +1,41 @@
 # frozen_string_literal: true
 
 module Staples
+  # Command-line interface for generating Rails applications with opinionated defaults.
+  #
+  # This class handles the creation of new Rails applications with predefined
+  # configuration options including PostgreSQL database, Bootstrap CSS, and
+  # skipping Solid Queue.
   class CLI
-    OPTIONS = [
+    # Default options passed to the Rails generator.
+    #
+    # @return [Array<String>] the list of Rails CLI options
+    BASE_OPTIONS = [
       "-d=postgresql",
       "--css=bootstrap",
       "--skip-solid"
     ]
 
+    # Initializes a new CLI instance.
+    #
+    # @param app_name [String] the name of the Rails application to create
     def initialize(app_name)
       @app_name = app_name
     end
 
+    # Creates and runs a new CLI instance.
+    #
+    # @param app_name [String] the name of the Rails application to create
+    # @return [Boolean] true if the Rails app was created successfully
+    # @raise [Error] if Rails is not installed or app creation fails
     def self.run(app_name)
       new(app_name).run
     end
 
+    # Executes the Rails application generation process.
+    #
+    # @return [Boolean] true if the Rails app was created successfully
+    # @raise [Error] if Rails is not installed or app creation fails
     def run
       verify_rails_exists!
       generate_new_rails_app
@@ -32,7 +52,10 @@ module Staples
     end
 
     def generate_new_rails_app
-      if system("rails", "new", app_name, *OPTIONS)
+      template_path = File.expand_path("../templates/base.rb", __dir__)
+      options = BASE_OPTIONS + ["-m=#{template_path}"]
+
+      if system("rails", "new", app_name, *options)
         true
       else
         raise Error, "Failed to create Rails app"

data/lib/staples/version.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# The Staples module provides a CLI tool for generating opinionated Rails applications.
 module Staples
-  VERSION = "0.1.0"
+  # The current version of the Staples gem.
+  VERSION = "1.0.0"
 end

data/lib/staples.rb

@@ -3,7 +3,12 @@
 require_relative "staples/version"
 require_relative "staples/cli"
 
+# The Staples module provides a CLI tool for generating opinionated Rails applications.
+#
+# This gem wraps the Rails application generator with a predefined set of options
+# to quickly scaffold new Rails projects with PostgreSQL, Bootstrap CSS, and other
+# opinionated defaults.
 module Staples
+  # Base error class for all Staples-specific errors.
   class Error < StandardError; end
-  # Your code goes here...
 end

data/lib/templates/Procfile

@@ -0,0 +1,3 @@
+release: bundle exec rails db:migrate; bundle exec rails db:seed
+web: bundle exec puma -C config/puma.rb
+worker: bundle exec sidekiq -c 10

data/lib/templates/README.md

@@ -0,0 +1,127 @@
+# README
+
+## Environment Variables
+
+- `DATABASE_URL` - PostgreSQL database connection string (required)
+- `APPLICATION_HOST` - The domain where your application is hosted (required, used for mailer URL generation)
+- `ASSET_HOST` - CDN or asset host URL (optional, for serving static assets)
+- `MAILER_SENDER` - Default email address for outgoing emails (defaults to `contact@example.com`)
+- `RAILS_MASTER_KEY` - Required for decrypting credentials (automatically set in CI)
+
+## Features
+
+### Authentication
+
+This application ships with a `user` model via [Devise][devise]. We prefer Devise over the [authentication generator][auth-generator] because...
+
+- It receives frequent security updates, whereas you're on your own with a generator.
+- It's widely adopted in the Rails community.
+- It has a [rich ecosystem][ecosystem].
+
+Additionally, the following modules are enabled:
+
+- [Database Authenticatable][database-authenticatable]
+- [Registerable][registerable]
+- [Recoverable][recoverable]
+- [Rememberable][rememberable]
+- [Validatable][validatable]
+- [Trackable][trackable]
+
+[database-authenticatable]: https://www.rubydoc.info/gems/devise/Devise/Models/DatabaseAuthenticatable
+[registerable]: https://www.rubydoc.info/gems/devise/Devise/Models/Registerable
+[recoverable]: https://www.rubydoc.info/gems/devise/Devise/Models/Recoverable
+[rememberable]: https://www.rubydoc.info/gems/devise/Devise/Models/Rememberable
+[validatable]: https://www.rubydoc.info/gems/devise/Devise/Models/Validatable
+[trackable]: https://www.rubydoc.info/gems/devise/Devise/Models/Trackable
+[devise]: https://github.com/heartcombo/devise
+[auth-generator]: https://guides.rubyonrails.org/security.html#authentication
+[ecosystem]: https://github.com/heartcombo/devise?tab=readme-ov-file#extensions
+
+### Organizations
+
+This application draws inspiration from [Laravel][laravel], [JumpStart][jumpstart], and [Bullet Train][bullettrain] by introducing the concept of "Teams" in an effort to make your application more resilient from day 0.
+
+When a `user` is created, we automatically create an `organization`, and associate the two via a `membership`.
+
+[laravel]: https://jetstream.laravel.com/features/teams.html
+[jumpstart]: https://jumpstartrails.com/docs/accounts
+[bullettrain]: https://blog.bullettrain.co/teams-should-be-an-mvp-feature/
+
+### Frontend
+
+This application proudly ships with [Bootstrap][bootstrap] as its frontend toolkit.
+
+Bootstrap is mature, battle tested, and well documented. It's basically the Rails of frontend toolkits for server-rendered applications. It gives you everything you need, (including a rich set of [JavaScript plugins][bootstrap-js]), and is [meant to be customized][bootstrap-customize].
+
+[bootstrap]: https://getbootstrap.com
+[bootstrap-js]: https://getbootstrap.com/docs/5.3/getting-started/javascript/
+[bootstrap-customize]: https://getbootstrap.com/docs/5.3/customize/overview/
+
+### Background Jobs
+
+This application ships with [Sidekiq][sidekiq] instead of [Solid Queue][solid-queue] simply because there's an [open issue][solid-queue-issue] with Solid Queue and Heroku.
+
+[sidekiq]: https://github.com/sidekiq/sidekiq
+[solid-queue]: https://github.com/rails/solid_queue/
+[solid-queue-issue]: https://github.com/rails/solid_queue/issues/330
+
+### Configuration
+
+#### Application
+
+The following configurations are applied to all environments:
+
+- `config.active_job.queue_adapter = :sidekiq` - Uses Sidekiq for background job processing
+- `config.active_record.strict_loading_by_default = true` - Enables strict loading to prevent N+1 queries
+- `config.active_record.strict_loading_mode = :n_plus_one_only` - Strict loading only raises errors for N+1 queries
+- `config.require_master_key = true` - Requires the master key to be present for encrypted credentials
+
+#### Production
+
+- `config.sandbox_by_default = true` - Database sessions are sandboxed by default in console
+- `config.active_record.action_on_strict_loading_violation = :log` - Logs strict loading violations instead of raising errors
+- `config.asset_host = ENV["ASSET_HOST"]` - Configures asset host from environment variable
+- `config.action_mailer.default_url_options = { host: ENV.fetch("APPLICATION_HOST") }` - Sets mailer host from environment variable
+
+#### Development
+
+- `config.active_model.i18n_customize_full_message = true` - Customizes full error messages for internationalization
+- `config.i18n.raise_on_missing_translations = true` - Raises errors when translations are missing
+- `config.generators.apply_rubocop_autocorrect_after_generate! = true` - Automatically runs RuboCop autocorrect after generating files
+
+#### Test
+
+- `config.action_dispatch.show_exceptions = :none` - Disables exception pages to allow errors to propagate in tests
+- `config.action_mailer.default_url_options = { host: "localhost", port: 3001 }` - Sets mailer host for test environment
+- `config.i18n.raise_on_missing_translations = true` - Raises errors when translations are missing
+- `config.active_job.queue_adapter = :inline` - Executes background jobs synchronously in tests
+
+### Strong Migrations
+
+This application ships with [Strong Migrations][strong-migrations] in order to catch unsafe migrations in development.
+
+[strong-migrations]: https://github.com/ankane/strong_migrations
+
+### Static Pages
+
+This application ships with [High Voltage][high-voltage] to easily include static pages.
+
+[high-voltage]: https://github.com/thoughtbot/high_voltage
+
+### Development Seeds
+
+This application provides a custom seeder task specifically for development and staging environments. Unlike `db/seeds.rb` which runs in all environments, the development seeder is isolated to local development.
+
+The seeder is implemented in `lib/development/seeder.rb` and can be run with:
+
+```bash
+rake development:db:seed
+```
+
+For a complete reset, use the replant task which truncates all tables before seeding:
+
+```bash
+rake development:db:seed:replant
+```
+
+**Important**: The development seeder should be idempotent, meaning it can be run multiple times without creating duplicate data or errors.

data/lib/templates/app/controllers/pages_controller.rb

@@ -0,0 +1,3 @@
+class PagesController < ApplicationController
+  include HighVoltage::StaticPage
+end

data/lib/templates/app/models/membership.rb

@@ -0,0 +1,4 @@
+class Membership < ApplicationRecord
+  belongs_to :user
+  belongs_to :organization
+end

data/lib/templates/app/models/organization.rb

@@ -0,0 +1,3 @@
+class Organization < ApplicationRecord
+  has_many :memberships, dependent: :restrict_with_exception
+end

data/lib/templates/app/models/user/account.rb

@@ -0,0 +1,24 @@
+module User::Account
+  extend ActiveSupport::Concern
+
+  included do
+    devise :database_authenticatable, :registerable,
+      :recoverable, :rememberable, :validatable,
+      :confirmable, :trackable
+
+    after_create_commit :create_initial_organization!
+
+    has_many :memberships, dependent: :destroy
+    has_many :organizations, through: :memberships
+  end
+
+  def organization
+    organizations.sole
+  end
+
+  private
+
+  def create_initial_organization!
+    organizations.create!
+  end
+end

data/lib/templates/app/models/user.rb

@@ -0,0 +1,3 @@
+class User < ApplicationRecord
+  include User::Account
+end

data/lib/templates/app/views/application/_card.html.erb

@@ -0,0 +1,5 @@
+<div class="card">
+  <div class="card-body">
+    <%= yield %>
+  </div>
+</div>

data/lib/templates/app/views/application/_error_messages.html.erb

@@ -0,0 +1,11 @@
+<%# locals: (resource: ) %>
+
+<% if resource.errors.any? %>
+  <div id="error_explanation" class="alert alert-danger" role="alert" data-turbo-cache="false">
+    <ul class="mb-0">
+      <% resource.errors.full_messages.each do |message| %>
+        <li><%= message %></li>
+      <% end %>
+    </ul>
+  </div>
+<% end %>

data/lib/templates/app/views/application/_flashes.html.erb

@@ -0,0 +1,10 @@
+<% if flash.any? %>
+  <div class="flashes">
+    <% flash.each do |type, message| -%>
+      <div class="<%= class_names("alert alert-dismissible fade show", "alert-success": type == "notice", "alert-danger": type == "alert") %>" role="alert">
+        <%= message %>
+        <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
+      </div>
+    <% end -%>
+  </div>
+<% end %>

data/lib/templates/app/views/application/_nav.html.erb

@@ -0,0 +1,27 @@
+<nav class="navbar navbar-expand-lg bg-body-tertiary mb-4" aria-label="Account">
+  <div class="container-fluid">
+    <%= link_to "Rails MVP", root_path, class: "navbar-brand" %>
+    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarAccount" aria-controls="navbarAccount" aria-expanded="false" aria-label="Toggle navigation">
+      <span class="navbar-toggler-icon"></span>
+    </button>
+    <div class="collapse navbar-collapse" id="navbarAccount">
+      <ul class="navbar-nav ms-auto mb-2 mb-lg-0">
+        <% if user_signed_in? %>
+          <li class="nav-item">
+            <%= active_link_to current_user.email, edit_user_registration_path, class: "nav-link" %>
+          </li>
+          <li class="nav-item">
+            <%= button_to "Log out", destroy_user_session_path, method: :delete, class: "nav-link" %>
+          </li>
+        <% else %>
+          <li class="nav-item">
+            <%= active_link_to "Log in", new_user_session_path, class: "nav-link" %>
+          </li>
+          <li class="nav-item">
+            <%= link_to "Register", new_user_registration_path, class: "nav-link" %>
+          </li>
+        <% end %>
+      </ul>
+    </div>
+  </div>
+</nav>

data/lib/templates/app/views/devise/confirmations/new.html.erb

@@ -0,0 +1,22 @@
+<% content_for :title, "Resend confirmation instructions" %>
+
+<h1 id="main_label" class="text-center"><%= content_for :title %></h1>
+
+<div class="mx-auto w-100" style="max-width: 400px;">
+  <%= render "card" do %>
+    <%= form_for(resource, as: resource_name, url: confirmation_path(resource_name), html: { method: :post }) do |f| %>
+      <%= render "error_messages", resource: resource %>
+
+      <div class="mb-3">
+        <%= f.label :email, class: "form-label" %>
+        <%= f.email_field :email, autofocus: true, autocomplete: "email", value: (resource.pending_reconfirmation? ? resource.unconfirmed_email : resource.email), class: "form-control" %>
+      </div>
+
+      <div class="mb-3">
+        <%= f.submit "Resend confirmation instructions", class: "btn btn-primary" %>
+      </div>
+    <% end %>
+
+    <%= render "devise/shared/links" %>
+  <% end %>
+</div>

data/lib/templates/app/views/devise/passwords/edit.html.erb

@@ -0,0 +1,31 @@
+<% content_for :title, "Change your password" %>
+
+<h1 id="main_label" class="text-center"><%= content_for :title %></h1>
+
+<div class="mx-auto w-100" style="max-width: 400px;">
+  <%= render "card" do %>
+    <%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :put }) do |f| %>
+      <%= render "error_messages", resource: resource %>
+      <%= f.hidden_field :reset_password_token %>
+
+      <div class="mb-3">
+        <%= f.label :password, "New password", class: "form-label" %>
+        <% if @minimum_password_length %>
+          <div class="form-text"><%= @minimum_password_length %> characters minimum</div>
+        <% end %>
+        <%= f.password_field :password, autofocus: true, autocomplete: "new-password", class: "form-control" %>
+      </div>
+
+      <div class="mb-3">
+        <%= f.label :password_confirmation, "Confirm new password", class: "form-label" %>
+        <%= f.password_field :password_confirmation, autocomplete: "new-password", class: "form-control" %>
+      </div>
+
+      <div class="mb-3">
+        <%= f.submit "Change my password", class: "btn btn-primary" %>
+      </div>
+    <% end %>
+
+    <%= render "devise/shared/links" %>
+  <% end %>
+</div>