plutonium 0.64.0 → 0.65.0

data/lib/generators/pu/dashboard/dashboard_generator.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require_relative "../lib/plutonium_generators"
+
+module Pu
+  # Scaffolds a dashboard class and mounts it in a portal (or the main app).
+  #
+  #   rails g pu:dashboard Sales --dest=admin_portal
+  #   rails g pu:dashboard Home --dest=admin_portal --at=/     # the portal root
+  #
+  # Writes `app/dashboards/<portal>/<name>_dashboard.rb` inside the package
+  # and adds `register_dashboard` to its routes. A root mount replaces the
+  # generated `root to: "dashboard#index"` line.
+  class DashboardGenerator < Rails::Generators::NamedBase
+    include PlutoniumGenerators::Generator
+
+    source_root File.expand_path("templates", __dir__)
+
+    desc(
+      "Create a dashboard and mount it in a portal\n\n" \
+      "e.g. rails g pu:dashboard Sales --dest=admin_portal\n" \
+      "     rails g pu:dashboard Home --dest=admin_portal --at=/"
+    )
+
+    class_option :at, type: :string, default: nil,
+      desc: "Mount path under the portal's dashboards/ segment (default: the dashboard name; \"/\" mounts at the root)"
+
+    def start
+      @app_namespace = portal_option(:dest, prompt: "Select destination portal").camelize
+
+      template "dashboard.rb", dashboard_file_path
+      register_dashboard_in_routes
+    rescue => e
+      exception "#{self.class} failed:", e
+    end
+
+    private
+
+    attr_reader :app_namespace
+
+    def main_app? = app_namespace == "MainApp"
+
+    def package_namespace = app_namespace.underscore
+
+    def dashboard_name = "#{class_name.delete_suffix("Dashboard")}Dashboard"
+
+    def dashboard_class_name
+      main_app? ? dashboard_name : "#{app_namespace}::#{dashboard_name}"
+    end
+
+    def dashboard_label = dashboard_name.delete_suffix("Dashboard").titleize
+
+    def mount_path
+      path = options[:at].presence || dashboard_name.delete_suffix("Dashboard").underscore
+      path.to_s.sub(%r{\A/+}, "").sub(%r{/+\z}, "")
+    end
+
+    def root_mount? = mount_path.empty?
+
+    def dashboard_file_path
+      file = "#{dashboard_name.underscore}.rb"
+      main_app? ? "app/dashboards/#{file}" : "packages/#{package_namespace}/app/dashboards/#{package_namespace}/#{file}"
+    end
+
+    def routes_path
+      main_app? ? "config/routes.rb" : "packages/#{package_namespace}/config/routes.rb"
+    end
+
+    def register_line
+      constant = main_app? ? "::#{dashboard_class_name}" : dashboard_class_name
+      %(register_dashboard #{constant}, at: "#{root_mount? ? "/" : mount_path}")
+    end
+
+    # Idempotent: skips when the routes already register this dashboard. A root
+    # mount replaces the portal's generated `root to:` line, since two roots
+    # would clash.
+    def register_dashboard_in_routes
+      content = File.read(File.join(destination_root, routes_path))
+
+      if /^\s*register_dashboard #{Regexp.escape("::" + dashboard_class_name)}\b|^\s*register_dashboard #{Regexp.escape(dashboard_class_name)}\b/.match?(content)
+        say_status :identical, "#{routes_path} already registers #{dashboard_class_name}", :blue
+        return
+      end
+
+      if root_mount? && (match = content.match(/^\s*root to: "dashboard#index".*\n/))
+        gsub_file routes_path, match[0], indent("#{register_line}\n", 2)
+      elsif /^\s*#\s*register resources above\b/.match?(content)
+        insert_into_file routes_path, indent("#{register_line}\n", 2), before: /^\s*#\s*register resources above\b.*/
+      elsif (match = content.match(/^\s*(\w+::Engine|Rails\.application)\.routes\.draw do.*\n/))
+        insert_into_file routes_path, indent("#{register_line}\n", 2), after: match[0]
+      else
+        say_status :warn, "Could not locate routes block in #{routes_path}; add manually: #{register_line}", :yellow
+      end
+    end
+  end
+end

data/lib/generators/pu/dashboard/templates/dashboard.rb.tt

@@ -0,0 +1,25 @@
+<%- if main_app? -%>
+class <%= dashboard_name %> < Plutonium::Dashboard::Base
+  presents label: "<%= dashboard_label %>"
+
+  # Cards sit on a 12-column grid (metric 3, chart and card 6 by default; `span:`
+  # overrides), each in its own lazy turbo frame. `group_by_day` is the groupdate gem.
+  #
+  # metric(:users, icon: Phlex::TablerIcons::Users) { authorized_resource_scope(User).count }
+  # chart(:signups, type: :line, span: 8) { User.group_by_day(:created_at, last: 30).count }
+  # card(:welcome) { p { "Signed in as #{current_user.email}" } }
+end
+<%- else -%>
+module <%= app_namespace %>
+  class <%= dashboard_name %> < Plutonium::Dashboard::Base
+    presents label: "<%= dashboard_label %>"
+
+    # Cards sit on a 12-column grid (metric 3, chart and card 6 by default; `span:`
+    # overrides), each in its own lazy turbo frame. `group_by_day` is the groupdate gem.
+    #
+    # metric(:users, icon: Phlex::TablerIcons::Users) { authorized_resource_scope(User).count }
+    # chart(:signups, type: :line, span: 8) { User.group_by_day(:created_at, last: 30).count }
+    # card(:welcome) { p { "Signed in as #{current_user.email}" } }
+  end
+end
+<%- end -%>

data/lib/generators/pu/docker/install/install_generator.rb

@@ -11,6 +11,11 @@ module Pu
 
       desc "Set up docker for project"
 
+      # Fallbacks when the tool is not on PATH at generation time.
+      NODE_LTS_VERSION = "22.23.2"
+      YARN_CLASSIC_VERSION = "1.22.22"
+      BUN_VERSION = "1.4.2"
+
       def start
         in_root do
           template "Dockerfile", force: true
@@ -30,6 +35,59 @@ module Pu
       def ruby_version
         @ruby_version ||= File.read(".ruby-version").strip
       end
+
+      # The JavaScript toolchain is chosen the same way jsbundling-rails will
+      # choose it at `assets:precompile` inside the image, and versions come
+      # from the machine generating the Dockerfile (or NODE_VERSION /
+      # YARN_VERSION / BUN_VERSION), like Rails' own template.
+      def using_bun?
+        js_package_manager == :bun
+      end
+
+      def dockerfile_node_version
+        ENV.fetch("NODE_VERSION") { node_version || NODE_LTS_VERSION }
+      end
+
+      def dockerfile_yarn_version
+        ENV.fetch("YARN_VERSION") { yarn_version || YARN_CLASSIC_VERSION }
+      end
+
+      def dockerfile_bun_version
+        ENV.fetch("BUN_VERSION") { bun_version || BUN_VERSION }
+      end
+
+      # Yarn 2+ is installed through corepack, and its lockfile flag is
+      # --immutable rather than yarn 1's --frozen-lockfile.
+      def yarn_through_corepack?
+        js_package_manager == :yarn && dockerfile_yarn_version.to_i >= 2
+      end
+
+      def js_lockfile_copy
+        case js_package_manager
+        when :bun then "package.json bun.lock*"
+        when :pnpm then "package.json pnpm-lock.yaml"
+        when :npm then "package.json package-lock.json"
+        # .yarnrc.yml carries nodeLinker for yarn 2+; the glob keeps the COPY
+        # valid on yarn 1 apps that have none.
+        else "package.json yarn.lock .yarnrc.yml*"
+        end
+      end
+
+      def js_frozen_install_command
+        case js_package_manager
+        when :bun then "bun install --frozen-lockfile"
+        when :pnpm then "pnpm install --frozen-lockfile"
+        when :npm then "npm ci"
+        else "yarn install --#{yarn_through_corepack? ? "immutable" : "frozen-lockfile"}"
+        end
+      end
+
+      # docker-compose runs this on every container start. `npm ci` would wipe
+      # node_modules each boot and fails without a package-lock.json, so npm
+      # gets a plain install; the others already only sync what changed.
+      def js_dev_install_command
+        (js_package_manager == :npm) ? "npm install" : js_install_command
+      end
     end
   end
 end

data/lib/generators/pu/docker/install/templates/Dockerfile.dev.tt

@@ -11,13 +11,28 @@ RUN apt-get update -qq && \
     apt-get install --no-install-recommends -y build-essential curl git libpq-dev node-gyp pkg-config python-is-python3
 
 # Install JavaScript dependencies
-ARG NODE_VERSION=22.2.0
-ARG YARN_VERSION=1.22.22
+<% if using_bun? -%>
+ENV BUN_INSTALL=/usr/local/bun
+ENV PATH=/usr/local/bun/bin:$PATH
+ARG BUN_VERSION=<%= dockerfile_bun_version %>
+RUN curl -fsSL https://bun.sh/install | bash -s -- "bun-v${BUN_VERSION}"
+<% else -%>
+ARG NODE_VERSION=<%= dockerfile_node_version %>
 ENV PATH=/usr/local/node/bin:$PATH
 RUN curl -sL https://github.com/nodenv/node-build/archive/master.tar.gz | tar xz -C /tmp/ && \
     /tmp/node-build-master/bin/node-build "${NODE_VERSION}" /usr/local/node && \
-    npm install -g yarn@$YARN_VERSION && \
     rm -rf /tmp/node-build-master
+<% if js_package_manager == :yarn -%>
+ARG YARN_VERSION=<%= dockerfile_yarn_version %>
+<% if yarn_through_corepack? -%>
+RUN corepack enable && corepack install -g yarn@$YARN_VERSION
+<% else -%>
+RUN npm install -g yarn@$YARN_VERSION
+<% end -%>
+<% elsif js_package_manager == :pnpm -%>
+RUN corepack enable && corepack install -g pnpm@latest
+<% end -%>
+<% end -%>
 
 # Additional dependencies go here
 

data/lib/generators/pu/docker/install/templates/Dockerfile.tt

@@ -22,13 +22,28 @@ RUN apt-get update -qq && \
     apt-get install --no-install-recommends -y build-essential curl git libpq-dev node-gyp pkg-config python-is-python3
 
 # Install JavaScript dependencies
-ARG NODE_VERSION=22.2.0
-ARG YARN_VERSION=1.22.22
+<% if using_bun? -%>
+ENV BUN_INSTALL=/usr/local/bun
+ENV PATH=/usr/local/bun/bin:$PATH
+ARG BUN_VERSION=<%= dockerfile_bun_version %>
+RUN curl -fsSL https://bun.sh/install | bash -s -- "bun-v${BUN_VERSION}"
+<% else -%>
+ARG NODE_VERSION=<%= dockerfile_node_version %>
 ENV PATH=/usr/local/node/bin:$PATH
 RUN curl -sL https://github.com/nodenv/node-build/archive/master.tar.gz | tar xz -C /tmp/ && \
     /tmp/node-build-master/bin/node-build "${NODE_VERSION}" /usr/local/node && \
-    npm install -g yarn@$YARN_VERSION && \
     rm -rf /tmp/node-build-master
+<% if js_package_manager == :yarn -%>
+ARG YARN_VERSION=<%= dockerfile_yarn_version %>
+<% if yarn_through_corepack? -%>
+RUN corepack enable && corepack install -g yarn@$YARN_VERSION
+<% else -%>
+RUN npm install -g yarn@$YARN_VERSION
+<% end -%>
+<% elsif js_package_manager == :pnpm -%>
+RUN corepack enable && corepack install -g pnpm@latest
+<% end -%>
+<% end -%>
 
 # Install application gems
 COPY .ruby-version Gemfile Gemfile.lock ./
@@ -37,8 +52,8 @@ RUN bundle install && \
     bundle exec bootsnap precompile --gemfile
 
 # Install node modules
-COPY package.json yarn.lock ./
-RUN yarn install --frozen-lockfile
+COPY <%= js_lockfile_copy %> ./
+RUN <%= js_frozen_install_command %>
 
 # Copy application code
 COPY . .

data/lib/generators/pu/docker/install/templates/{docker-compose.yml → docker-compose.yml.tt}

@@ -22,7 +22,7 @@ x-app: &app
 services:
   web:
     <<: *app
-    command: /bin/sh -c "rm -f tmp/pids/server.pid && bundle && yarn && bin/dev" # web
+    command: /bin/sh -c "rm -f tmp/pids/server.pid && bundle && <%= js_dev_install_command %> && bin/dev" # web
     # web properties
     ports: # web
       - "3000:3000" # app

data/lib/generators/pu/gem/dotenv/dotenv_generator.rb

@@ -19,7 +19,7 @@ module Pu
 
           copy_file "config/initializers/001_ensure_required_env.rb"
 
-          gitignore "!/.env", "!/.env.template", "!/.env.local.template", "!/.env.test.local"
+          gitignore "!/.env", "!/.env.template", "!/.env.local.template"
 
           insert_into_file "Gemfile", "\ngem \"dotenv\", groups: %i[development test]\n", after: /^gem ["']rails["'].*\n/
           bundle!

data/lib/generators/pu/invites/invitable_generator.rb

@@ -22,7 +22,7 @@ module Pu
         desc: "The user model name"
 
       class_option :membership_model, type: :string,
-        desc: "The membership model name (defaults to EntityUser)"
+        desc: "The membership model name (e.g. OrganizationUser). When omitted, the generated interaction has no membership_class override and you must implement it yourself"
 
       class_option :dest, type: :string, default: "main_app",
         desc: "Destination package for the interaction"
@@ -51,6 +51,23 @@ module Pu
         end
       end
 
+      def warn_membership_model_default
+        return if behavior == :revoke
+        return if options[:membership_model].present?
+
+        say_status :warning,
+          "No --membership-model specified — generated interaction will not include a membership_class override.",
+          :yellow
+        say <<~MSG.indent(2)
+
+          The generated #{model_class}::InviteUserInteraction raises
+          NotImplementedError from #membership_class at runtime until you either:
+            - re-run with --membership-model=NAME (e.g. --membership-model=OrganizationUser), or
+            - manually override #membership_class to return your membership join model.
+
+        MSG
+      end
+
       def create_interaction
         template "invitable/invite_user_interaction.rb",
           interaction_path

data/lib/generators/pu/lib/plutonium_generators/concerns/actions.rb

@@ -29,101 +29,6 @@ module PlutoniumGenerators
         end
       end
 
-      # #
-      # # Adds a new gem into the Gemfile
-      # # Existing directives are updated if they do not match
-      # # When `:group` is specified, the gem is inserted into the approriate gem group.
-      # #
-      # # @param [String] name the name of the gem
-      # # @param [Hash] **kwargs set of options to append see #super
-      # #
-      # # @return [void]
-      # #
-      # def gem(name, **kwargs)
-      #   groups = Array(kwargs.delete(:group))
-
-      #   in_root do
-      #     begin
-      #       # Create a temp gemfile
-      #       File.rename("Gemfile", "Gemfile.bak")
-      #       File.write("Gemfile", "")
-      #       # Generate the directive
-      #       super
-      #       # Get the generated directive
-      #       directive = gemfile.strip
-      #     ensure
-      #       # Restore our gemfile
-      #       File.delete "Gemfile"
-      #       File.rename "Gemfile.bak", "Gemfile"
-      #     end
-
-      #     pattern = /^# gem ['"]#{name}['"].*/
-      #     if gemfile.match(pattern)
-      #       # Replace commented out directive
-      #       gsub_file("Gemfile", pattern, directive)
-      #       break
-      #     end
-
-      #     # Remove existing directive
-      #     remove_gem name
-
-      #     # Insert the new directive
-      #     if groups != []
-      #       str = groups.sort.map(&:inspect).join(", ")
-      #       after_sentinel = "group #{str} do\n"
-
-      #       unless File.read("Gemfile").match?(/^#{after_sentinel}/)
-      #         inject_into_file "Gemfile", "\n#{after_sentinel}end\n"
-      #       end
-      #     else
-      #       after_sentinel = "# Project gems\n\n"
-      #       unless File.read("Gemfile").match?(/^#{after_sentinel}/)
-      #         inject_into_file "Gemfile", "\n#{after_sentinel}", after: /^ruby .*\n/
-      #       end
-      #     end
-
-      #     inject_into_file "Gemfile", "#{directive}\n", after: /^#{after_sentinel}/
-      #   end
-      # end
-
-      # #
-      # # Removes a gem and any preceeding comments from the Gemfile
-      # #
-      # # @param gem [String] the name of the gem to remove
-      # #
-      # # @return [void]
-      # #
-      # def remove_gem(gem)
-      #   log :remove_gem, gem
-      #   gsub_file "Gemfile", /(:?^.*#.*\n)*.*gem ['"]#{gem}['"].*\n/, "", verbose: false
-      # end
-
-      # #
-      # # Evaluates the given template and merges it with the project's docker-compose.yml
-      # #
-      # # @param [String] source the template filename
-      # #
-      # # @return [void]
-      # #
-      # def docker_compose(source)
-      #   log :docker_compose, source
-
-      #   in_root do
-      #     compose_file = "docker-compose.yml"
-      #     compose_definition = YAML.load_file(compose_file) if File.exist?(compose_file)
-      #     compose_definition ||= {
-      #       version: "3.7",
-      #       services: {}
-      #     }
-      #     compose_definition.deep_stringify_keys!
-
-      #     new_definition = YAML.load template_eval("docker-compose/#{source}.yml.tt")
-      #     compose_definition.deep_merge! new_definition.deep_stringify_keys
-
-      #     create_file compose_file, YAML.dump(compose_definition), force: true
-      #   end
-      # end
-
       def managed_compose(file = "docker-compose.yml")
         @managed_compose ||= {}
 

data/lib/generators/pu/lib/plutonium_generators/concerns/js_package_manager.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+begin
+  # jsbundling-rails `main` ships the detector its build task uses (unreleased
+  # as of 1.3.1).
+  require "jsbundling/package_manager"
+rescue LoadError
+  # Older jsbundling-rails, or an app without it: fall back to the same rules.
+end
+
+module PlutoniumGenerators
+  module Concerns
+    # Detects the host app's JavaScript package manager and builds the matching
+    # shell commands, so generators never hardcode `yarn`.
+    #
+    # Detection follows what `rails javascript:build` consults at precompile
+    # time. Installing with the same tool keeps a single lockfile: the lockfile
+    # decides, and with no lockfile the first executable on PATH among bun,
+    # yarn, pnpm and npm wins (yarn when none is found). `rails new -j esbuild`
+    # therefore yields a bun app on any machine that has bun installed, and
+    # this concern follows it rather than adding a yarn.lock next to bun.lock.
+    # When the app's jsbundling-rails provides Jsbundling::PackageManager, that
+    # detector is used as is (it skips yarn.lock and decides by PATH).
+    #
+    # Yarn 1 (classic) and Yarn 2+ (berry) share `add` but differ elsewhere;
+    # `yarn_berry?` distinguishes them by asking the yarn the app resolves to.
+    module JsPackageManager
+      ADD_COMMANDS = {
+        bun: "bun add %s",
+        pnpm: "pnpm add %s",
+        npm: "npm install %s",
+        yarn: "yarn add %s"
+      }.freeze
+
+      INSTALL_COMMANDS = {
+        bun: "bun install",
+        pnpm: "pnpm install",
+        npm: "npm ci",
+        yarn: "yarn install"
+      }.freeze
+
+      RUN_COMMANDS = {
+        bun: "bun run %s",
+        pnpm: "pnpm run %s",
+        npm: "npm run %s",
+        yarn: "yarn %s"
+      }.freeze
+
+      LOCKFILES = {
+        bun: %w[bun.lock bun.lockb],
+        pnpm: %w[pnpm-lock.yaml],
+        npm: %w[package-lock.json],
+        yarn: %w[yarn.lock]
+      }.freeze
+
+      protected
+
+      # @return [Symbol] one of :bun, :pnpm, :npm, :yarn
+      def js_package_manager
+        @js_package_manager ||= detect_js_package_manager
+      end
+
+      # One command that adds every package. `pkg@latest` and `pkg@^1.2.3`
+      # are understood identically by all four managers, which is why callers
+      # pass versions inline instead of running a separate upgrade step
+      # (yarn 1 `upgrade --latest` has no yarn 2+ equivalent).
+      def js_add_command(*packages)
+        format(ADD_COMMANDS.fetch(js_package_manager), packages.flatten.join(" "))
+      end
+
+      def js_install_command
+        INSTALL_COMMANDS.fetch(js_package_manager)
+      end
+
+      def js_run_command(script)
+        format(RUN_COMMANDS.fetch(js_package_manager), script)
+      end
+
+      # Yarn 2+ ("berry"). Asks the yarn the app resolves to, so corepack and
+      # a `packageManager` field are honoured.
+      def yarn_berry?
+        js_package_manager == :yarn && yarn_version.to_i >= 2
+      end
+
+      def yarn_version
+        @yarn_version ||= capture_tool_version("yarn --version")
+      end
+
+      def bun_version
+        @bun_version ||= capture_tool_version("bun --version")
+      end
+
+      def node_version
+        @node_version ||= capture_tool_version("node --version")
+      end
+
+      # Yarn 2+ defaults to Plug'n'Play, which Tailwind's PostCSS plugin cannot
+      # be loaded under (postcss-load-config's require() options are not
+      # supported by PnP). Pin the node-modules linker, which is what the rest
+      # of the Rails toolchain expects, unless the app already chose a linker.
+      def ensure_yarn_node_modules_linker
+        return unless yarn_berry?
+
+        yarnrc = ".yarnrc.yml"
+        existing = in_root_dir { File.exist?(yarnrc) ? File.read(yarnrc) : nil }
+
+        if existing.nil?
+          create_file yarnrc, "nodeLinker: node-modules\n"
+        elsif existing.match?(/^nodeLinker:/)
+          unless existing.match?(/^nodeLinker:\s*node-modules\b/)
+            warn "#{yarnrc} sets a nodeLinker other than node-modules; the Tailwind PostCSS plugin does not load under Plug'n'Play"
+          end
+        else
+          append_to_file yarnrc, "nodeLinker: node-modules\n"
+        end
+      end
+
+      private
+
+      def detect_js_package_manager
+        root = Pathname(destination_root)
+        return Jsbundling::PackageManager.detect(root) if defined?(Jsbundling::PackageManager)
+
+        LOCKFILES.each do |manager, files|
+          return manager if files.any? { |f| root.join(f).exist? }
+        end
+        return :bun if root.join("bun.config.js").exist?
+
+        %i[bun yarn pnpm npm].find { |exe| system("command -v #{exe} > /dev/null") } || :yarn
+      end
+
+      def capture_tool_version(command)
+        output = in_root_dir { `#{command} 2>/dev/null` }
+        output[/\d+\.\d+\.\d+/]
+      rescue SystemCallError
+        nil
+      end
+
+      # Thor's in_root returns the block value too, but only once the generator
+      # has a destination stack; this stays usable from plain unit tests.
+      def in_root_dir(&)
+        Dir.chdir(destination_root, &)
+      end
+    end
+  end
+end

data/lib/generators/pu/lib/plutonium_generators/generator.rb

@@ -5,10 +5,9 @@ require "tty-prompt"
 
 module PlutoniumGenerators
   module Generator
-    include Concerns::Config
     include Concerns::Logger
-    include Concerns::Serializer
     include Concerns::Actions
+    include Concerns::JsPackageManager
 
     # Finds the shared namespace prefix between two model names.
     # Used to derive association names when models share a namespace.
@@ -58,20 +57,5 @@ module PlutoniumGenerators
         TTY::Prompt.new
       end
     end
-
-    # def appname
-    #   defined?(Rails.application) ? Rails.application.class.module_parent.name : "PlutoniumGenerators"
-    # end
-
-    # def app_name
-    #   appname.underscore
-    # end
-
-    def pug_installed?(feature, version: nil)
-      installed_version = read_config(:installed, feature)
-      return false unless installed_version.present?
-
-      version.present? ? SemanticRange.satisfies?(installed_version, ">=#{version}") : true
-    end
   end
 end

data/lib/generators/pu/pkg/package/package_generator.rb

@@ -17,6 +17,7 @@ module Pu
         validate_package_name package_name
 
         template "lib/engine.rb", "packages/#{package_namespace}/lib/engine.rb"
+        template "config/locales/en.yml", "packages/#{package_namespace}/config/locales/en.yml"
 
         %w[controllers interactions models policies definitions].each do |dir|
           directory "app/#{dir}", "packages/#{package_namespace}/app/#{dir}/#{package_namespace}"

data/lib/generators/pu/pkg/package/templates/config/locales/en.yml.tt

@@ -0,0 +1,28 @@
+# Wording for the <%= package_name %> package's resources.
+#
+# This file is loaded automatically (the package is a Rails engine) ahead of
+# the host app's config/locales, so the app can still override anything here.
+#
+# Model and attribute names follow the Rails convention; placeholders, hints
+# and derived labels follow Plutonium's:
+#
+#   en:
+#     activerecord:
+#       models:
+#         <%= package_namespace %>/post:
+#           one: "Post"
+#           other: "Posts"
+#       attributes:
+#         <%= package_namespace %>/post:
+#           title: "Title"
+#     plutonium:
+#       fields:
+#         <%= package_namespace %>/post:
+#           title:
+#             placeholder: "A short, descriptive title"
+#       actions:
+#         <%= package_namespace %>/post:
+#           publish: "Publish now"
+#
+# See https://radioactive-labs.github.io/plutonium-core/reference/i18n
+en: {}

data/lib/generators/pu/pkg/portal/portal_generator.rb

@@ -25,6 +25,7 @@ module Pu
 
         template "lib/engine.rb", "packages/#{package_namespace}/lib/engine.rb"
         template "config/routes.rb", "packages/#{package_namespace}/config/routes.rb"
+        template "config/locales/en.yml", "packages/#{package_namespace}/config/locales/en.yml"
 
         template "app/controllers/concerns/controller.rb",
           "packages/#{package_namespace}/app/controllers/#{package_namespace}/concerns/controller.rb"