nextgen 0.1.0

data/template/.eslintrc.cjs

@@ -0,0 +1,26 @@
+/** @type {import("@types/eslint").Linter.Config */
+
+module.exports = {
+  env: {
+    browser: true,
+    es2021: true,
+  },
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: "module",
+  },
+  plugins: ["prettier"],
+  rules: {
+    "no-unused-vars": [
+      "error",
+      {
+        args: "after-used",
+        argsIgnorePattern: "^_",
+        varsIgnorePattern: "^_",
+      },
+    ],
+    "no-var": "error",
+    "prettier/prettier": "error",
+  },
+  extends: ["eslint:recommended", "prettier"],
+};

data/template/.github/workflows/ci.yml.tt

@@ -0,0 +1,142 @@
+name: CI
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+env:
+  RAILS_ENV: test
+jobs:
+<% if minitest? || rspec? -%>
+  test:
+    name: "<%= minitest? ? "Test" : "RSpec" %>"
+    runs-on: ubuntu-latest
+<% if gems.include?("pg") -%>
+    env:
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/ci
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_DB: ci
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
+<% end -%>
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+<% if File.exist?("package.json") -%>
+      - uses: actions/setup-node@v3
+        with:
+<% if File.exist?(".node-version") -%>
+          node-version-file: ".node-version"
+<% else -%>
+          node-version: "lts/*"
+<% end -%>
+          cache: yarn
+      - run: npx --yes ci
+<% end -%>
+<% if gems.include?("capybara") -%>
+      - run: mkdir -p ./tmp/screenshots
+<% end -%>
+<% if File.exist?("config/database.yml") -%>
+      - run: bundle exec rake db:prepare
+<% end -%>
+<% if rspec? -%>
+      - run: bundle exec rspec
+<% else -%>
+      - run: bundle exec rake test:all
+<% end -%>
+<% if gems.include?("capybara") -%>
+      - uses: actions/upload-artifact@v3
+        if: failure()
+        with:
+          name: capybara-screenshots
+          path: ./tmp/screenshots/
+          retention-days: 7
+          if-no-files-found: ignore
+<% end -%>
+<% end -%>
+<% if gems.include?("erb_lint") -%>
+  erblint:
+    name: "Lint / erblint"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - run: bin/erblint --lint-all
+<% end -%>
+<% if Dir[".eslintrc*"].any? -%>
+  eslint:
+    name: "Lint / eslint"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v3
+        with:
+<% if File.exist?(".node-version") -%>
+          node-version-file: ".node-version"
+<% else -%>
+          node-version: "lts/*"
+<% end -%>
+          cache: yarn
+      - run: npx --yes ci
+      - run: yarn lint:js
+<% end -%>
+<% if gems.include?("rubocop") -%>
+  rubocop:
+    name: "Lint / rubocop"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - run: bin/rubocop
+<% end -%>
+<% if Dir[".stylelintrc*"].any? -%>
+  stylelint:
+    name: "Lint / stylelint"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v3
+        with:
+<% if File.exist?(".node-version") -%>
+          node-version-file: ".node-version"
+<% else -%>
+          node-version: "lts/*"
+<% end -%>
+          cache: yarn
+      - run: npx --yes ci
+      - run: yarn lint:css
+<% end -%>
+<% if gems.include?("brakeman") -%>
+  brakeman:
+    name: "Security / brakeman"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - run: bundle exec brakeman --exit-on-warn --no-progress --color --output /dev/stdout
+<% end -%>
+<% if gems.include?("bundler-audit") -%>
+  bundle-audit:
+    name: "Security / bundle-audit"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - run: bundle exec bundle-audit check --update -v
+<% end -%>

data/template/.overcommit.yml.tt

@@ -0,0 +1,86 @@
+gemfile: false
+verify_signatures: false
+
+PreCommit:
+  BundleCheck:
+    enabled: true
+
+<% if File.exist?(".erb-lint.yml") -%>
+  ErbLint:
+    enabled: true
+    required_executable: bundle
+    command: ["bundle", "exec", "erblint"]
+    include: "**/*.html.erb"
+<% end -%>
+
+<% if File.exist?(".eslintrc.cjs") -%>
+  EsLint:
+    enabled: true
+    required_executable: npx
+    command: ["npx", "--no-install", "eslint", "-f", "compact"]
+    include:
+      - app/assets/**/*.js
+      - app/assets/**/*.jsx
+      - app/components/**/*.js
+      - app/components/**/*.jsx
+      - app/frontend/**/*.js
+      - app/frontend/**/*.jsx
+      - app/javascript/**/*.js
+      - app/javascript/**/*.jsx
+      - app/assets/**/*.ts
+      - app/assets/**/*.tsx
+      - app/components/**/*.ts
+      - app/components/**/*.tsx
+      - app/frontend/**/*.ts
+      - app/frontend/**/*.tsx
+      - app/javascript/**/*.ts
+      - app/javascript/**/*.tsx
+<% end -%>
+
+  FixMe:
+    enabled: true
+    keywords: ["FIXME"]
+    exclude:
+      - .overcommit.yml
+
+  LocalPathsInGemfile:
+    enabled: true
+
+<% if File.exist?("config/database.yml") -%>
+  RailsSchemaUpToDate:
+    enabled: true
+<% end -%>
+
+<% if File.exist?(".rubocop.yml") -%>
+  RuboCop:
+    enabled: true
+    required_executable: bundle
+    command: ["bundle", "exec", "rubocop"]
+    on_warn: fail
+<% end -%>
+
+<% if File.exist?(".stylelintrc.cjs") -%>
+  Stylelint:
+    enabled: true
+    required_executable: npx
+    command: ["npx", "--no-install", "stylelint"]
+    include:
+      - app/assets/**/*.css
+      - app/components/**/*.css
+      - app/frontend/**/*.css
+      - app/javascript/**/*.css
+<% end -%>
+
+  TrailingWhitespace:
+    enabled: true
+    exclude:
+      - "**/db/structure.sql"
+
+<% if File.exist?("yarn.lock") -%>
+  YarnCheck:
+    enabled: true
+<% end -%>
+
+PostCheckout:
+  ALL:
+    quiet: true

data/template/.prettierrc.cjs

@@ -0,0 +1,6 @@
+/** @type {import("prettier").Config} */
+
+module.exports = {
+  tabWidth: 2,
+  useTabs: false,
+};

data/template/.rubocop.yml.tt

@@ -0,0 +1,269 @@
+require:
+<%= plugins.map { "  - rubocop-#{_1}" }.join("\n") %>
+
+inherit_mode:
+  merge:
+    - Include
+
+AllCops:
+  DisplayCopNames: true
+  DisplayStyleGuide: true
+  NewCops: enable
+  Include:
+    - .tomo/**/*.rb
+  Exclude:
+    # ignore bin/* except for bin/setup
+    - !ruby/regexp /<%%= Regexp.quote(File.expand_path("bin", __dir__)) %>\/(?!setup).*/
+    - .git/**/*
+    - db/*schema.rb
+    - log/**/*
+    - node_modules/**/*
+    - public/**/*
+    - storage/**/*
+    - tmp/**/*
+    - vendor/**/*
+
+Layout/ArgumentAlignment:
+  EnforcedStyle: with_fixed_indentation
+
+Layout/ExtraSpacing:
+  AllowForAlignment: false
+  AllowBeforeTrailingComments: true
+  ForceEqualSignAlignment: false
+
+Layout/FirstArrayElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/FirstArrayElementLineBreak:
+  Enabled: true
+
+Layout/FirstHashElementLineBreak:
+  Enabled: true
+
+Layout/FirstMethodArgumentLineBreak:
+  Enabled: true
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: key
+  EnforcedColonStyle: key
+  EnforcedLastArgumentHashStyle: always_inspect
+
+Layout/LineLength:
+  Exclude:
+    - config/initializers/content_security_policy.rb
+
+Layout/MultilineArrayLineBreaks:
+  Enabled: true
+
+Layout/MultilineHashKeyLineBreaks:
+  Enabled: true
+
+Layout/MultilineMethodArgumentLineBreaks:
+  Enabled: true
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Layout/MultilineOperationIndentation:
+  EnforcedStyle: indented
+
+Layout/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: no_space
+  EnforcedStyleForEmptyBraces: no_space
+
+Lint/AmbiguousBlockAssociation:
+  Enabled: false
+
+Lint/DuplicateBranch:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Max: 25
+  Exclude:
+    - config/**/*
+    - test/**/*
+
+Metrics/ClassLength:
+  Max: 200
+  Exclude:
+    - test/**/*
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 25
+  Exclude:
+    - bin/setup
+    - db/migrate/*
+    - test/**/*
+
+Metrics/ModuleLength:
+  Max: 200
+  Exclude:
+    - config/**/*
+
+Metrics/ParameterLists:
+  Max: 6
+
+Metrics/PerceivedComplexity:
+  Max: 8
+  Exclude:
+    - bin/setup
+
+<% if plugins.include?("minitest") -%>
+Minitest/AssertPredicate:
+  Enabled: false
+
+Minitest/AssertTruthy:
+  Enabled: false
+
+Minitest/EmptyLineBeforeAssertionMethods:
+  Enabled: false
+
+Minitest/MultipleAssertions:
+  Enabled: false
+
+Minitest/RefuteFalse:
+  Enabled: false
+
+Minitest/RefutePredicate:
+  Enabled: false
+<% end -%>
+
+Naming/FileName:
+  Exclude:
+    - .tomo/plugins/*.rb
+
+Naming/MemoizedInstanceVariableName:
+  Enabled: false
+
+Naming/VariableNumber:
+  Enabled: false
+
+Rails/ApplicationRecord:
+  Exclude:
+    - db/migrate/**
+
+Rails/BulkChangeTable:
+  Enabled: false
+
+Rails/DefaultScope:
+  Enabled: true
+
+Rails/Delegate:
+  Enabled: false
+
+Rails/EnvironmentVariableAccess:
+  Enabled: false
+
+Rails/HasAndBelongsToMany:
+  Enabled: false
+
+Rails/HttpStatus:
+  Enabled: false
+
+Rails/I18nLocaleTexts:
+  Enabled: false
+
+Rails/Inquiry:
+  Enabled: false
+
+Rails/NotNullColumn:
+  Enabled: false
+
+Rails/RakeEnvironment:
+  Enabled: false
+
+Rails/RefuteMethods:
+  Enabled: false
+
+Rails/RequireDependency:
+  Enabled: true
+
+Rails/RootPathnameMethods:
+  Enabled: false
+
+Rails/SkipsModelValidations:
+  Enabled: false
+
+<% if Gem::Version.new(Rails.version) >= Gem::Version.new("7.1.0.beta1") -%>
+Rails/UnknownEnv:
+  Environments:
+    - development
+    - test
+    - production
+    - local
+<% end -%>
+
+Rails/Validation:
+  Enabled: false
+
+Style/Alias:
+  Enabled: false
+
+Style/AsciiComments:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/EmptyMethod:
+  EnforcedStyle: expanded
+
+Style/FetchEnvVar:
+  Enabled: false
+
+Style/FormatStringToken:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/GuardClause:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/ModuleFunction:
+  Enabled: false
+
+Style/NumericPredicate:
+  Enabled: false
+
+Style/PerlBackrefs:
+  Enabled: false
+
+Style/RescueStandardError:
+  EnforcedStyle: implicit
+
+Style/SingleLineMethods:
+  AllowIfMethodIsEmpty: false
+
+Style/StringConcatenation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/SymbolArray:
+  Enabled: false
+
+Style/TrivialAccessors:
+  AllowPredicates: true
+
+Style/YodaExpression:
+  Enabled: false

data/template/.stylelintrc.cjs

@@ -0,0 +1,52 @@
+module.exports = {
+  plugins: ["stylelint-declaration-strict-value"],
+  extends: ["stylelint-config-standard", "stylelint-prettier/recommended"],
+  rules: {
+    "color-hex-length": null,
+    "declaration-empty-line-before": null,
+    "declaration-no-important": true,
+    "import-notation": null,
+    "max-nesting-depth": 1,
+    "no-empty-source": null,
+    "no-invalid-position-at-import-rule": null,
+    "property-no-unknown": [
+      true,
+      {
+        // Allow property used for css-fonts-4 variable fonts
+        ignoreProperties: ["font-named-instance"],
+      },
+    ],
+    "scale-unlimited/declaration-strict-value": [
+      "/color/",
+      {
+        disableFix: true,
+        ignoreValues: [
+          "currentcolor",
+          "inherit",
+          "initial",
+          "transparent",
+          "unset",
+        ],
+      },
+    ],
+    "selector-class-pattern": [
+      // classes must be in BEM form, like this:
+      // my_component
+      // my_component--variant
+      // my_component__element
+      // my_component__element--variant
+      // my_component__long_element_name
+      // my_component__long_element_name--variant
+      "^[a-z]+(_[a-z]+)*(__[a-z]+(_[a-z]+)*)?(--[a-z]+(_[a-z]+)*)*$",
+      {
+        resolveNestedSelectors: true,
+        message:
+          "Classes must be in BEM form like `my_component__element--variant`",
+      },
+    ],
+    "selector-max-compound-selectors": 2,
+    "selector-max-id": 0,
+    "selector-no-qualifying-type": true,
+    "shorthand-property-no-redundant-values": null,
+  },
+};

data/template/DEPLOYMENT.md

@@ -0,0 +1,10 @@
+# Deployment
+
+## Environment variables
+
+These environment variables affect how the app functions when deployed in production.
+
+- `RAILS_DISABLE_SSL` - Disable HSTS and secure cookies
+- `RAILS_MAX_THREADS` - Number of threads per Puma process (default: 5)
+- **REQUIRED** `SECRET_KEY_BASE` - Unique, secret key used to encrypt and sign cookies and other sensitive data
+- `WEB_CONCURRENCY` - Number of Puma processes (default: number of CPUs)

data/template/Procfile.tt

@@ -0,0 +1,4 @@
+web: bundle exec puma -C config/puma.rb
+<% if File.exist?("config/database.yml") -%>
+release: bundle exec rake db:migrate
+<% end -%>

data/template/README.md.tt

@@ -0,0 +1,52 @@
+# <%= app_name %>
+
+This is a Rails <%= Rails::VERSION::MAJOR %>.<%= Rails::VERSION::MINOR %> app.
+
+## Prerequisites
+
+This project requires:
+
+- Ruby (see [.ruby-version](./.ruby-version)), preferably managed using [rbenv](https://github.com/rbenv/rbenv)
+<% if postgres -%>
+- PostgreSQL must be installed and accepting connections
+<% end -%>
+
+On macOS, these [Homebrew](http://brew.sh) packages are recommended:
+
+```
+brew install rbenv
+<% if postgres -%>
+brew install postgresql@16
+<% end -%>
+```
+
+## Getting started
+
+### bin/setup
+
+Run this script to install necessary dependencies and prepare the Rails app to be started for the first time.
+
+```
+bin/setup
+```
+
+> [!NOTE]
+> The `bin/setup` script is idempotent and is designed to be run often. You should run it every time you pull code that introduces new dependencies or makes other significant changes to the project.
+
+### Run the app!
+
+Start the Rails server with this command:
+
+```
+bin/rails s
+```
+
+The app will be located at <http://localhost:3000/>.
+
+## Development
+
+Use this command to run the full suite of automated tests:
+
+```
+bin/rake
+```

data/template/Thorfile

@@ -0,0 +1,7 @@
+require_relative "config/environment" unless %w[-h --help help -T list -v version].include?(ARGV.first)
+
+class << Thor
+  def exit_on_failure?
+    true
+  end
+end

data/template/app/controllers/concerns/basic_auth.rb

@@ -0,0 +1,20 @@
+module BasicAuth
+  extend ActiveSupport::Concern
+
+  included do
+    before_action :require_basic_auth
+  end
+
+  private
+
+  def require_basic_auth
+    expected_username = ENV.fetch("BASIC_AUTH_USERNAME", nil)
+    expected_password = ENV.fetch("BASIC_AUTH_PASSWORD", nil)
+    return true if expected_username.blank? || expected_password.blank?
+
+    authenticate_or_request_with_http_basic do |username, password|
+      ActiveSupport::SecurityUtils.secure_compare(username, expected_username) & \
+        ActiveSupport::SecurityUtils.secure_compare(password, expected_password)
+    end
+  end
+end

data/template/app/controllers/home_controller.rb

@@ -0,0 +1,4 @@
+class HomeController < ApplicationController
+  def index
+  end
+end

data/template/app/frontend/controllers/index.js

@@ -0,0 +1,5 @@
+import { application } from "./application";
+import { registerControllers } from "stimulus-vite-helpers";
+
+const controllers = import.meta.glob("./**/*_controller.js", { eager: true });
+registerControllers(application, controllers);

data/template/app/frontend/images/example.svg

@@ -0,0 +1,3 @@
+<svg width="180" height="180" viewBox="0 0 180 180" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect x="2" y="2" width="176" height="176" rx="6" fill="white" stroke="#CCCCCC" stroke-width="4" stroke-miterlimit="0" stroke-linecap="round"/>
+</svg>