better_app_gen 0.1.0

data/lib/better_app_gen/generators/docker.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Sets up Docker development environment
+    class Docker < Base
+      def generate!
+        create_directory(".docker")
+        create_directory("script")
+
+        create_dockerfile
+        create_dockerfile_prod
+        create_compose_files
+        create_docker_env
+        create_docker_entrypoint
+        create_docker_entrypoint_prod
+        create_management_scripts
+        create_robots_txt
+        create_deploy_docs
+      end
+
+      private
+
+      def create_dockerfile
+        create_file_from_template(".docker/Dockerfile.dev", "docker/Dockerfile.dev.erb")
+      end
+
+      def create_dockerfile_prod
+        create_file_from_template(".docker/Dockerfile.prod", "docker/Dockerfile.prod.erb")
+      end
+
+      def create_compose_files
+        create_file_from_template("compose.yml", "docker/compose.yml.erb")
+        create_file_from_template("compose.runner.yml", "docker/compose.runner.yml.erb")
+      end
+
+      def create_docker_env
+        create_file_from_template(".env.docker", "docker/env.docker.erb")
+      end
+
+      def create_docker_entrypoint
+        create_file_from_template("bin/docker-entrypoint", "bin/docker-entrypoint.erb")
+        chmod_executable("bin/docker-entrypoint")
+      end
+
+      def create_docker_entrypoint_prod
+        create_file_from_template("bin/docker-entrypoint.prod", "bin/docker-entrypoint.prod.erb")
+        chmod_executable("bin/docker-entrypoint.prod")
+      end
+
+      def create_deploy_docs
+        create_file_from_template(".docker/DEPLOY.md", "docker/DEPLOY.md.erb")
+      end
+
+      def create_management_scripts
+        scripts = %w[dc-up dc-down dc-shell dc-rails dc-logs dc-logs-tail dc-attach dc-build dc-restart]
+
+        scripts.each do |script|
+          template_name = "script/#{script}.erb"
+          template_path = BetterAppGen.templates_path.join(template_name)
+          next unless template_path.exist?
+
+          create_file_from_template("script/#{script}", template_name)
+          chmod_executable("script/#{script}")
+        end
+      end
+
+      def create_robots_txt
+        create_file_from_template("public/robots.txt", "public/robots.txt.erb")
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/gemfile.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Configures the Gemfile with required gems
+    class Gemfile < Base
+      SOLID_GEMS = [
+        'gem "solid_cache"',
+        'gem "solid_queue"',
+        'gem "solid_cable"'
+      ].freeze
+
+      BASE_GEMS = [
+        'gem "rails-i18n"',
+        'gem "better_vite_helper"'
+      ].freeze
+
+      def generate!
+        gems_to_add = SOLID_GEMS + BASE_GEMS
+        gems_to_add << 'gem "simple_form"' if with_simple_form
+
+        merge_gemfile(gems_to_add)
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/home_controller.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Creates HomeController with index action and root route
+    class HomeController < Base
+      def generate!
+        create_directory("app/views/home")
+        create_controller
+        create_helper
+        create_view
+        create_routes
+      end
+
+      private
+
+      def create_controller
+        create_file_from_template("app/controllers/home_controller.rb", "app/controllers/home_controller.rb.erb")
+      end
+
+      def create_helper
+        create_file_from_template("app/helpers/home_helper.rb", "app/helpers/home_helper.rb.erb")
+      end
+
+      def create_view
+        create_file_from_template("app/views/home/index.html.erb", "app/views/home/index.html.erb.erb")
+      end
+
+      def create_routes
+        create_file_from_template("config/routes.rb", "config/routes.rb.erb")
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/locale.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Configures i18n with the selected locale
+    class Locale < Base
+      def generate!
+        create_locale_file if locale != "en"
+      end
+
+      private
+
+      def create_locale_file
+        template_name = "config/locales/#{locale}.yml.erb"
+
+        # Only create if template exists for this locale
+        template_path = BetterAppGen.templates_path.join(template_name)
+        return unless template_path.exist?
+
+        create_file_from_template("config/locales/#{locale}.yml", template_name)
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/rails_app.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Creates the base Rails application with optimized skip flags
+    class RailsApp < Base
+      SKIP_FLAGS = %w[
+        --skip-git
+        --skip-docker
+        --skip-action-mailbox
+        --skip-action-text
+        --skip-active-storage
+        --skip-test
+        --skip-ci
+        --skip-kamal
+        --skip-devcontainer
+        --skip-jbuilder
+        --skip-javascript
+        --skip-asset-pipeline
+        --database=postgresql
+      ].freeze
+
+      def generate!
+        create_rails_app
+        cleanup_schema_files
+        setup_migration_directories
+      end
+
+      private
+
+      def create_rails_app
+        command = "rails new #{app_name} #{SKIP_FLAGS.join(" ")}"
+        Dir.chdir(File.dirname(app_path)) do
+          # Run rails command outside of bundler environment
+          Bundler.with_unbundled_env do
+            success = system(command)
+            raise RailsGenerationError unless success
+          end
+        end
+      end
+
+      def cleanup_schema_files
+        # Remove schema.rb files (we use structure.sql instead)
+        schema_files = Dir.glob(File.join(app_path, "db", "*schema.rb"))
+        schema_files << File.join(app_path, "db", "schema.rb")
+
+        schema_files.each do |file|
+          FileUtils.rm_f(file)
+        end
+      end
+
+      def setup_migration_directories
+        create_directory("db/migrate")
+        create_directory("db/cache_migrate")
+        create_directory("db/queue_migrate")
+        create_directory("db/cable_migrate")
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/simple_form.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Configures SimpleForm with Tailwind CSS styling
+    class SimpleForm < Base
+      def generate!
+        create_initializer
+        create_locale_file if locale != "en"
+      end
+
+      private
+
+      def create_initializer
+        create_file_from_template(
+          "config/initializers/simple_form.rb",
+          "config/initializers/simple_form.rb.erb"
+        )
+      end
+
+      def create_locale_file
+        template_name = "config/locales/simple_form.#{locale}.yml.erb"
+        template_path = BetterAppGen.templates_path.join(template_name)
+        return unless template_path.exist?
+
+        create_file_from_template(
+          "config/locales/simple_form.#{locale}.yml",
+          template_name
+        )
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/solid_stack.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Configures Solid Stack (Cache, Queue, Cable) in application.rb
+    class SolidStack < Base
+      def generate!
+        create_application_rb
+      end
+
+      private
+
+      def create_application_rb
+        create_file_from_template("config/application.rb", "config/application.rb.erb")
+      end
+    end
+  end
+end

data/lib/better_app_gen/generators/vite.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module BetterAppGen
+  module Generators
+    # Sets up Vite 7 + Tailwind CSS 4 + Stimulus
+    class Vite < Base
+      DEPENDENCIES = {
+        "@hotwired/stimulus" => "^3.2.2",
+        "@hotwired/turbo-rails" => "^8.0.12"
+      }.freeze
+
+      DEV_DEPENDENCIES = {
+        "@tailwindcss/postcss" => "^4.0.0",
+        "autoprefixer" => "^10.4.20",
+        "postcss" => "^8.5.1",
+        "tailwindcss" => "^4.0.0",
+        "vite" => "^6.0.7"
+      }.freeze
+
+      SCRIPTS = {
+        "dev" => "vite --host 0.0.0.0 --port 5173",
+        "build" => "vite build"
+      }.freeze
+
+      def generate!
+        setup_directories
+        setup_package_json
+        create_vite_config
+        create_postcss_config
+        create_stylesheets
+        create_javascript
+        create_initializer
+        create_procfile
+        create_bin_dev
+        create_yarnrc
+        create_gitignore
+        create_env_files
+        create_layout
+      end
+
+      private
+
+      def setup_directories
+        create_directory("app/assets/images")
+        create_directory("app/javascript/controllers")
+        create_directory("app/assets/stylesheets")
+
+        # Remove default application.css if exists
+        css_file = File.join(app_path, "app/assets/stylesheets/application.css")
+        FileUtils.rm_f(css_file)
+      end
+
+      def setup_package_json
+        scripts = SCRIPTS.dup
+        scripts["dev"] = "vite --host 0.0.0.0 --port #{vite_port}"
+
+        merge_package_json(
+          dependencies: DEPENDENCIES,
+          dev_dependencies: DEV_DEPENDENCIES,
+          scripts: scripts,
+          extra: {
+            "type" => "module",
+            "packageManager" => "yarn@4.5.3"
+          }
+        )
+      end
+
+      def create_vite_config
+        create_file_from_template("vite.config.js", "vite/vite.config.js.erb")
+      end
+
+      def create_postcss_config
+        create_file_from_template("postcss.config.js", "vite/postcss.config.js.erb")
+      end
+
+      def create_stylesheets
+        create_file_from_template("app/assets/stylesheets/application.css", "vite/application.css.erb")
+      end
+
+      def create_javascript
+        create_file_from_template("app/javascript/application.js", "vite/application.js.erb")
+        create_file_from_template("app/javascript/controllers/application.js",
+                                  "vite/controllers/application.js.erb")
+        create_file_from_template("app/javascript/controllers/hello_controller.js",
+                                  "vite/controllers/hello_controller.js.erb")
+        create_file_from_template("app/javascript/controllers/index.js", "vite/controllers/index.js.erb")
+      end
+
+      def create_initializer
+        create_file_from_template("config/initializers/better_vite_helper.rb",
+                                  "config/initializers/better_vite_helper.rb.erb")
+      end
+
+      def create_procfile
+        create_file_from_template("Procfile.dev", "root/Procfile.dev.erb")
+      end
+
+      def create_bin_dev
+        create_file_from_template("bin/dev", "bin/dev.erb")
+        chmod_executable("bin/dev")
+      end
+
+      def create_yarnrc
+        create_file_from_template(".yarnrc.yml", "root/yarnrc.yml.erb")
+      end
+
+      def create_gitignore
+        create_file_from_template(".gitignore", "root/gitignore.erb")
+      end
+
+      def create_env_files
+        create_file_from_template(".env.example", "root/env.example.erb")
+        create_file_from_template(".env", "root/env.example.erb")
+      end
+
+      def create_layout
+        create_file_from_template("app/views/layouts/application.html.erb",
+                                  "app/views/layouts/application.html.erb.erb")
+      end
+    end
+  end
+end

data/lib/better_app_gen/templates/app/controllers/home_controller.rb.erb

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

data/lib/better_app_gen/templates/app/helpers/home_helper.rb.erb

@@ -0,0 +1,2 @@
+module HomeHelper
+end

data/lib/better_app_gen/templates/app/views/home/index.html.erb.erb

@@ -0,0 +1,2 @@
+<h1>Welcome to <%= app_name_pascal %></h1>
+<p>Your Rails 8 application is running successfully!</p>

data/lib/better_app_gen/templates/app/views/layouts/application.html.erb.erb

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+  <title><%%= content_for(:title) || "<%= app_name_pascal %>" %></title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <meta name="apple-mobile-web-app-capable" content="yes">
+  <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">
+
+  <%# Includes all stylesheet files in app/assets/stylesheets %>
+  <%# stylesheet_link_tag "application", "data-turbo-track": "reload" %>
+  <%# javascript_include_tag "application", "data-turbo-track": "reload", type: "module" %>
+
+  <%%= vite_stylesheet_link_tag "application.css" %>
+  <%%= vite_javascript_include_tag "application.js" %>
+</head>
+
+<body>
+  <%%= yield %>
+</body>
+
+</html>

data/lib/better_app_gen/templates/bin/dev.erb

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+
+if gem list --no-installed --exact --silent foreman; then
+  echo "Installing foreman..."
+  gem install foreman
+fi
+
+# Default to port <%= rails_port %> if not specified
+export PORT="${PORT:-<%= rails_port %>}"
+
+exec foreman start -f Procfile.dev --env /dev/null "$@"

data/lib/better_app_gen/templates/bin/docker-entrypoint.erb

@@ -0,0 +1,7 @@
+#!/bin/bash -e
+
+if [ -f /app/tmp/pids/server.pid ]; then
+  rm -f /app/tmp/pids/server.pid
+fi
+
+exec "${@}"

data/lib/better_app_gen/templates/bin/docker-entrypoint.prod.erb

@@ -0,0 +1,12 @@
+#!/bin/bash -e
+
+# Remove stale PID
+if [ -f /app/tmp/pids/server.pid ]; then
+  rm -f /app/tmp/pids/server.pid
+fi
+
+# Always run migrations in single-container setup
+echo "Running database migrations..."
+bundle exec rails db:prepare
+
+exec "${@}"

data/lib/better_app_gen/templates/config/application.rb.erb

@@ -0,0 +1,80 @@
+require_relative "boot"
+
+require "rails"
+# Pick the frameworks you want:
+require "active_model/railtie"
+require "active_job/railtie"
+require "active_record/railtie"
+# require "active_storage/engine"
+require "action_controller/railtie"
+require "action_mailer/railtie"
+# require "action_mailbox/engine"
+# require "action_text/engine"
+require "action_view/railtie"
+require "action_cable/engine"
+# require "rails/test_unit/railtie"
+
+# Require the gems listed in Gemfile, including any gems
+# you've limited to :test, :development, or :production.
+Bundler.require(*Rails.groups)
+
+module <%= app_name_pascal %>
+  class Application < Rails::Application
+    # Initialize configuration defaults for originally generated Rails version.
+    config.load_defaults 8.0
+
+    # Logging settings
+    config.log_level = ENV.fetch("RAILS_LOG_LEVEL", "info")
+
+    # Autoload libs
+    config.autoload_lib(ignore: %w[assets tasks generators])
+
+    # Rails web console settings
+    config.web_console.permissions = "0.0.0.0/0"
+
+    # I18n default settings
+    config.i18n.load_path        += Rails.root.glob("config/locales/**/*.{rb,yml}/*.{rb,yml}/**/*.{rb,yml}/*.{rb,yml}")
+    config.i18n.available_locales = [ :<%= locale %> ]
+    config.i18n.default_locale    = :<%= locale %>
+    config.time_zone              = "<%= timezone %>"
+
+    # Action Dispatch config
+    config.public_file_server.enabled = ENV["RAILS_SERVE_STATIC_FILES"].present?
+
+    # Use structure.sql instead of schema.rb
+    config.active_record.schema_format = :sql
+
+    # SMTP Settings
+    config.action_mailer.delivery_method = :smtp
+
+    unless Rails.env.test?
+      config.action_mailer.smtp_settings = {
+        address:              ENV.fetch("SMTP_ADDRESS", nil),
+        port:                 ENV.fetch("SMTP_PORT", nil).to_i,
+        domain:               ENV.fetch("SMTP_DOMAIN", nil),
+        user_name:            ENV.fetch("SMTP_USERNAME", nil),
+        password:             ENV.fetch("SMTP_PASSWORD", nil),
+        authentication:       ENV.fetch("SMTP_AUTHENTICATION", "plain"),
+        enable_starttls_auto: ActiveModel::Type::Boolean.new.cast(ENV.fetch("SMTP_ENABLE_STARTTLS_AUTO", true)),
+        open_timeout:         ENV.fetch("SMTP_OPEN_TIMEOUT", 5).to_i,
+        read_timeout:         ENV.fetch("SMTP_READ_TIMEOUT", 5).to_i
+      }
+    end
+
+    # Clear hosts
+    config.hosts.clear
+
+    # Don't generate system test files.
+    config.generators do |g|
+      g.orm :active_record, primary_key_type: :uuid
+      g.system_tests nil
+    end
+
+    # Cache with SolidCache
+    config.cache_store = :solid_cache_store
+
+    # ActiveJob with SolidCache
+    config.active_job.queue_adapter = :solid_queue
+    config.solid_queue.connects_to = { database: { writing: :queue } }
+  end
+end

data/lib/better_app_gen/templates/config/database.yml.erb

@@ -0,0 +1,65 @@
+default: &default
+  adapter: postgresql
+  encoding: unicode
+  schema_search_path: "public,shared"
+  pool: <%%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
+
+development:
+  primary: &primary_development
+    <<: *default
+    url: <%%= ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_development
+  cache:
+    <<: *primary_development
+    url: <%%= ENV['CACHE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_development_cache
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *primary_development
+    url: <%%= ENV['QUEUE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_development_queue
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *primary_development
+    url: <%%= ENV['CABLE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_development_cable
+    migrations_paths: db/cable_migrate
+
+test:
+  primary: &primary_test
+    <<: *default
+    url: <%%= ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_test
+  cache:
+    <<: *primary_test
+    url: <%%= ENV['CACHE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_test_cache
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *primary_test
+    url: <%%= ENV['QUEUE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_test_queue
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *primary_test
+    url: <%%= ENV['CABLE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_test_cable
+    migrations_paths: db/cable_migrate
+
+production:
+  primary: &primary_production
+    <<: *default
+    url: <%%= ENV['DATABASE_URL'] %>
+    database: <%= app_name_snake %>_production
+  cache:
+    <<: *primary_production
+    url: <%%= ENV['CACHE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *primary_production
+    url: <%%= ENV['QUEUE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *primary_production
+    url: <%%= ENV['CABLE_DATABASE_URL'] || ENV['DATABASE_URL'] %>
+    migrations_paths: db/cable_migrate

data/lib/better_app_gen/templates/config/initializers/active_record_schema_settings.rb.erb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+ActiveRecord::Tasks::DatabaseTasks.structure_dump_flags = ['-v', '--clean', '--if-exists']

data/lib/better_app_gen/templates/config/initializers/better_vite_helper.rb.erb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+BetterViteHelper.configure do |config|
+  config.dev_server_url = ENV.fetch("VITE_DEV_SERVER_URL", "http://localhost:<%= vite_port %>")
+end

data/lib/better_app_gen/templates/config/initializers/simple_form.rb.erb

@@ -0,0 +1,21 @@
+SimpleForm.setup do |config|
+  # Wrappers configuration with Tailwind classes
+  config.wrappers :default, class: "mb-4" do |b|
+    b.use :html5
+    b.use :placeholder
+    b.use :label, class: "block text-sm font-medium text-gray-700 mb-1"
+    b.use :input, class: "mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500 sm:text-sm", error_class: "border-red-300 focus:border-red-500 focus:ring-red-500"
+    b.use :error, wrap_with: { tag: :span, class: "text-red-600 text-sm mt-1" }
+  end
+
+  # Default configuration
+  config.generate_additional_classes_for = []
+  config.default_wrapper                 = :default
+  config.button_class                    = "bg-indigo-600 hover:bg-indigo-700 text-white font-bold py-2 px-4 rounded focus:outline-none focus:shadow-outline"
+  config.label_text                      = lambda { |label, _, _| label }
+  config.error_notification_tag          = :div
+  config.error_notification_class        = "bg-red-100 border border-red-400 text-red-700 px-4 py-3 rounded mb-4"
+  config.browser_validations             = false
+  config.boolean_style                   = :nested
+  config.boolean_label_class             = "inline-flex items-center"
+end