potassium 6.3.0 → 6.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6e930d3ad3b2989b3fd4e3675da60f6dec57089d0eba9eabe4d1bccbcae68de
-  data.tar.gz: 50ca1761257ba7f22d0724a3f1996a703d39dfefab842d4198cc99f7392741d0
+  metadata.gz: 0bc57ea8c0f92d1ce3dd15feef9164f7bef381ce322051bd810a3303c8ca257c
+  data.tar.gz: f31b33309764331c194d97380a37ccd0afdfa50ccd38eeba7931e330262179c3
 SHA512:
-  metadata.gz: 7044e4cfce08ab3cca65a7dbc30ec8be951ab478f368067955a8435bac40fe4c769f0a8b2b38828ab93614c0eeac8fe67d68c1f59ae3d8317b424c848e639c33
-  data.tar.gz: c699ee1eedb6b15512acbbdb6b53bab2e98b65e7aab413d398d47042e58e1c16ee8b786394674d6b07ba93f248a51f4da7bf366eaf184d0a13e4527d99647fe5
+  metadata.gz: c88f8cd6cb7f6814233c608c05aabb77369ab11887a64256efbba4e813c8cf1d2ee9c4fffc3ca9c45e24618b70e8e652318969cd38f50d7741888e06bdde1333
+  data.tar.gz: 788dbd755914cae98ca2bbd6c4f3566deacdf8eccba0a0b50eaff92facbc95b31bd23ec31a9a4026e0643dfe9fa0a8a888b3c962dd3cc557c184b3d69f245a54

data/.circleci/config.yml

@@ -1,6 +1,6 @@
 version: 2.1
 
-ruby-image: &ruby-image circleci/ruby:2.7.0-node
+ruby-image: &ruby-image cimg/ruby:2.7.4-node
 env-vars: &env-vars
   BUNDLE_JOBS: 4
   RAILS_ENV: test

data/.node-version

@@ -1 +1 @@
-12
+14

data/CHANGELOG.md

@@ -2,6 +2,51 @@
 
 ## Unreleased
 
+## 6.6.0
+Features
+  - Update power api gem to use v2.0.0. Install "internal" API mode [#394](https://github.com/platanus/potassium/pull/394)
+  - Updates Webpacker to Shakapacker, upgrading Vue and TailwindCSS to their latest versions [#395](https://github.com/platanus/potassium/pull/395)
+  - Add some image handling and processing in shrine file storage option [#398](https://github.com/platanus/potassium/pull/398)
+  - Include `--platanus-config` option to skip most of the instalation options [#399](https://github.com/platanus/potassium/pull/399).
+  - Add [`rubocop-platanus`](https://github.com/platanus/rubocop-platanus) gem for linting platanus' best practices [#402](https://github.com/platanus/potassium/pull/402).
+  - Remove graphql option [#404](https://github.com/platanus/potassium/pull/404)
+  - Add frontend testing coverage for Jest [#401](https://github.com/platanus/potassium/pull/401) and associated reviewdog comments [#406](https://github.com/platanus/potassium/pull/406)
+  - Add MJML to handle mail templates, with example [#405](https://github.com/platanus/potassium/pull/405)
+
+Fixes
+  - Add missing vips CI config when selecting shrine [#403](https://github.com/platanus/potassium/pull/403).
+  - Fix shakapacker to version 6.2.x to avoid [this bug](https://github.com/shakacode/shakapacker/issues/123) [#404](https://github.com/platanus/potassium/pull/404)
+
+## 6.5.0
+
+Features
+  - Update node to latest LTS version, 14 [#363](https://github.com/platanus/potassium/pull/363)
+  - Update ActiveAdmin to 2.9 to fix CSV streaming issues [#384](https://github.com/platanus/potassium/pull/384)
+  - Separates Pundit's configuration for Active Admin from Application's configuration [#378](https://github.com/platanus/potassium/pull/378)
+  - Add SimpleCov recipe [#387](https://github.com/platanus/potassium/pull/387)
+  - Update Rails to 6.1 [#389](https://github.com/platanus/potassium/pull/389) & [#392](https://github.com/platanus/potassium/pull/392)
+  - Include `run_test` as a valid example group [#379](https://github.com/platanus/potassium/pull/379). This was added incorrectly in this [PR](https://github.com/platanus/potassium/pull/379).
+  - Add system tests configuration [#388](https://github.com/platanus/potassium/pull/388)
+  - Allow CircleCI cache clearing [#383](https://github.com/platanus/potassium/pull/383)
+
+Fixes
+  - Remove rails_stdout_logging gem because it is no longer needed after Rails 5 and it was generating a deprecation warning [#325](https://github.com/platanus/potassium/pull/325)
+  - Fix default action dissapearance when using `binding.pry` in generated projects [#385](https://github.com/platanus/potassium/pull/385)
+
+## 6.4.0
+
+Features
+  - Include `run_test` as a valid example group [#379](https://github.com/platanus/potassium/pull/379)
+  - Updates ActiveAdmin installation to use webpacker [#350](https://github.com/platanus/potassium/pull/350)
+  - Replaces Active Skin with Arctic Admin [#350](https://github.com/platanus/potassium/pull/350)
+
+Fixes
+  - Forces `vue-loader` version to 15, as 16 requires `@vue/compiler-sfc`, which is a part of Vue 3 [#375](https://github.com/platanus/potassium/pull/375)
+  - Changes Content Security Policy added by GTM recipe to: [#375](https://github.com/platanus/potassium/pull/375)
+    - Include the same config regardless of environment
+    - Include `unsafe_eval` in `script_src`, as it is required for Vue's compiler build
+  - Changes the front-end test to avoid using the deprecated method `isVueInstance` [#376](https://github.com/platanus/potassium/pull/376)
+
 ## 6.3.0
 
 Features:

data/README.md

@@ -21,6 +21,34 @@ Use the `potassium create` command to create a new project:
 > 2. If you feel that it's too slow, you may need to update rubygems: `gem update --system`.
 > 3. Potassium uses node under the hood, so a check will also be performed to ensure you are running the supported version.
 
+#### Platanus Configutarion
+
+In case you want to use the Platanus Configuration you should use the following command:
+
+    $ potassium create <project-name> --platanus-config
+
+This will create a project with the following configuration:
+  1. `database`: `'postgresql'`
+  2. `local`: `'es-CL'`
+  3. `email_service`: `'sendgrid'`
+  4. `devise`: `true`
+  5. `devise-user-model`: `true`
+  6. `admin`: `true`
+  7. `vue_admin`: `true`
+  8. `pundit`: `true`
+  9. `api`: `true`
+  10. `storage`: `'shrine'`
+  11. `heroku`: `true`
+  12. `background_processor`: `true`
+  13. `draper`: `true`
+  14. `schedule`: `true`
+  15. `sentry`: `true`
+  16. `front_end`: `'vue'`
+  17. `google_tag_manager`: `true`
+  18. `test`: `true`
+  19. `spring`: `true`
+
+The remaining question will be asked as usual.
 ### Adding recipes to an existing project
 
 Use the `potassium install` command to add a recipe to a project:
@@ -53,6 +81,7 @@ Potassium Rails apps includes the following gems and technologies:
 - [Tzinfo-Data](https://github.com/tzinfo/tzinfo-data) for updating timezone information
 - [Faker](https://github.com/stympy/faker) for creating development data
 - [Scout](https://github.com/scoutapp/scout_apm_ruby) for monitoring performance
+- [Mjml](https://github.com/sighmon/mjml-rails) for mails style
 
 The following optional integrations are also added:
 
@@ -93,7 +122,6 @@ The optional API support includes:
 
 When you choose to deploy to heroku a few extra things are added for the project.
 
-  - Adds the [Rails Stdout Logging][logging-gem] gem to configure the app to log to standard out, which is how [Heroku's logging][heroku-logging] works
   - Adds a [Procfile][procfile] to define the processes to run in heroku
   - Setup continuous integration using docker and herokuish to maintain better parity between testing and production environments
   - Adds a `bin/release` file with the release phase script to run specific tasks before the app is deployed completely, for example `rails db:migrate:with_data`
@@ -129,7 +157,6 @@ Go to https://circleci.com/add-projects, choose the repository from the list and
 
 In order to enable code linting via CircleCI and ReviewDog, you need to activate the **Only build pull requests** option under the `Advanced settings` section for your project.
 
-[logging-gem]: https://github.com/heroku/rails_stdout_logging
 [heroku-logging]: https://devcenter.heroku.com/articles/logging#writing-to-your-log
 [procfile]: https://devcenter.heroku.com/articles/procfile
 [heroku-buildpack-ruby-version]: http://github.com/platanus/heroku-buildpack-ruby-version
@@ -179,4 +206,4 @@ potassium is maintained by [platanus](http://platan.us).
 
 ## License
 
-Potassium is © 2014 Platanus, SPA. It is free software and may be redistributed under the terms specified in the LICENSE file.
+Potassium is © 2014 Platanus, SPA. It is free software and may be redistributed under the terms specified in the [LICENSE](/LICENSE.txt) file.

data/docs/CONTRIBUTING.md

@@ -54,7 +54,7 @@ This method is used if you need to ask something to the user before doing someth
     ```ruby
     def ask
       use_banana_split = answer(:banana_split) do
-        Ask.confirm("Do you wan to use Banana Split?")
+        Ask.confirm("Do you want to use Banana Split?")
       end
       set(:use_banana_split, true) if use_banana_split
     end
@@ -103,7 +103,7 @@ For example if you run `portassium install devise` this will use
 [the recipe template](/lib/potassium/templates/recipe.rb) to load an execute the
 `install` method for the **devise** recipe.
 
-You can defined the main functionallity of a recipe in a private method and call
+You can define the main functionallity of a recipe in a private method and call
 it from the `create` and `install` methods.
 
 ```ruby

data/lib/potassium/assets/.circleci/config.yml.erb

@@ -1,6 +1,6 @@
 version: 2.1
 
-ruby-image: &ruby-image circleci/ruby:<%= ruby_version %>
+ruby-image: &ruby-image cimg/ruby:<%= ruby_version %>
 <%- if selected?(:database, :postgresql) -%>
 postgres-image: &postgres-image postgres:<%= Potassium::POSTGRES_VERSION %>
 <%- end -%>
@@ -12,6 +12,9 @@ env-vars: &env-vars
   BUNDLE_PATH: vendor/bundle
   RAILS_ENV: test
 
+orbs:
+  browser-tools: circleci/browser-tools@1.1
+
 executors:
   test-executor:
     docker:
@@ -37,14 +40,19 @@ commands:
 
       - restore_cache:
           keys:
-          - bundle-dependencies-{{ checksum "Gemfile.lock" }}
+          - bundle-dependencies-{{ .Environment.BUNDLE_CACHE_VERSION }}-{{ checksum "Gemfile.lock" }}
           - bundle-dependencies-
 
       - restore_cache:
           keys:
-          - yarn-dependencies-{{ checksum "yarn.lock" }}
+          - yarn-dependencies-{{ .Environment.YARN_CACHE_VERSION }}-{{ checksum "yarn.lock" }}
           - yarn-dependencies-
 
+      - run:
+          name: Install reviewdog
+          command: |
+            curl -sfL https://raw.githubusercontent.com/reviewdog/reviewdog/master/install.sh | sh -s -- -b ./bin
+
       - run:
           name: Install bundle dependencies
           command: |
@@ -62,20 +70,29 @@ commands:
             yarn install --frozen-lockfile
 
       - save_cache:
-          key: bundle-dependencies-{{ checksum "Gemfile.lock" }}
+          key: bundle-dependencies-{{ .Environment.BUNDLE_CACHE_VERSION }}-{{ checksum "Gemfile.lock" }}
           paths:
             - vendor/bundle
 
       - save_cache:
-          key: yarn-dependencies-{{ checksum "yarn.lock" }}
+          key: yarn-dependencies-{{ .Environment.YARN_CACHE_VERSION }}-{{ checksum "yarn.lock" }}
           paths:
             - node_modules
+      <%- if selected?(:storage, :shrine) -%>
+      - run:
+          name: Install apt and vips buildpack dependencies
+          command: |
+            xargs -a Aptfile sudo apt-get install
+            sudo apt-get install libvips
+      <%- end -%>
 
 jobs:
   test:
     executor: test-executor
     steps:
       - setup
+      - browser-tools/install-chrome
+      - browser-tools/install-chromedriver
 
       <%- if selected?(:background_processor) -%>
       - run:
@@ -93,16 +110,32 @@ jobs:
       <%- end -%>
 
       - run:
-          name: Run rspec
+          name: Run RSpec unit tests
           command: |
             RSPEC_JUNIT_ARGS="-r rspec_junit_formatter -f RspecJunitFormatter -o test_results/rspec.xml"
             RSPEC_FORMAT_ARGS="-f progress --no-color -p 10"
             bundle exec rspec spec $RSPEC_FORMAT_ARGS $RSPEC_JUNIT_ARGS
 
+      - run:
+          name: Run RSpec system tests
+          command: |
+            RSPEC_JUNIT_ARGS="-r rspec_junit_formatter -f RspecJunitFormatter -o test_results/rspec-system.xml"
+            RSPEC_FORMAT_ARGS="--tag type:system -f progress --no-color -p 10"
+            bundle exec rspec spec $RSPEC_FORMAT_ARGS $RSPEC_JUNIT_ARGS
+
+      - run:
+          name: Run simplecov
+          shell: /bin/bash
+          command: |
+            cat coverage/coverage.txt | ./bin/reviewdog -reporter=github-pr-review -efm="%f:%l:%c: %m"
+
       <%- if selected?(:front_end, :vue) -%>
       - run:
           name: Run jest
-          command: yarn run test
+          command: |
+            yarn run test > coverage/input_jest.txt
+            ./node_modules/.bin/format-coverage coverage/input_jest.txt coverage/output_jest.txt /home/circleci/project/app/javascript
+            cat coverage/output_jest.txt | ./bin/reviewdog -reporter=github-pr-review -efm="%f:%l:%c: %m"
       <%- end -%>
 
       - store_test_results:
@@ -113,11 +146,6 @@ jobs:
     steps:
       - setup
 
-      - run:
-          name: Install reviewdog
-          command: |
-            curl -sfL https://raw.githubusercontent.com/reviewdog/reviewdog/master/install.sh | sh -s -- -b ./bin
-
       - run:
           name: Get files to lint
           command: git diff origin/master --name-only --diff-filter=d > tmp/files_to_lint

data/lib/potassium/assets/.eslintrc.json

@@ -1,12 +1,16 @@
 {
   "env": {
-    "es6": true
+    "browser": true,
+    "es2021": true,
+    "node": true,
+    "jest/globals": true,
+    "vue/setup-compiler-macros": true
   },
   "parserOptions": {
-    "ecmaVersion": 2018,
+    "ecmaVersion": 2020,
     "sourceType": "module"
   },
-  "plugins": ["import"],
+  "plugins": ["import", "jest", "tailwindcss"],
   "settings": {
     "import/resolver": {
       "node": {
@@ -15,7 +19,10 @@
     }
   },
   "extends": [
-    "plugin:vue/strongly-recommended"
+    "plugin:vue/vue3-recommended",
+    "@vue/typescript/recommended",
+    "@vue/eslint-config-typescript",
+    "plugin:tailwindcss/recommended"
   ],
   "rules": {
     "accessor-pairs": 0,
@@ -338,14 +345,13 @@
     "vue/max-len": ["error", {
       "code": 120,
       "ignoreHTMLAttributeValues": true
-  }]
+    }]
   },
   "overrides": [
     {
-      "files": ["**/*.js"],
-      "excludedFiles": "app/**/*.js",
-      "env": {
-        "node": true
+      "files": ["*.ts", "*.vue"],
+      "rules": {
+        "no-undef": "off"
       }
     }
   ]

data/lib/potassium/assets/.pryrc

@@ -4,9 +4,3 @@ if defined?(PryByebug)
   Pry.commands.alias_command 'n', 'next'
   Pry.commands.alias_command 'f', 'finish'
 end
-
-if defined?(Rails)
-  require 'rails/console/app'
-  require 'rails/console/helpers'
-  include Rails::ConsoleMethods # rubocop:disable Style/MixinUsage
-end

data/lib/potassium/assets/.rubocop.yml

@@ -2,6 +2,7 @@ require:
   - rubocop-rspec
   - rubocop-rails
   - rubocop-performance
+  - rubocop-platanus
 AllCops:
   Exclude:
   - "vendor/**/*"

data/lib/potassium/assets/Aptfile

@@ -0,0 +1,5 @@
+libglib2.0-0
+libglib2.0-dev
+libpoppler-glib8
+libwebp-dev
+webp

data/lib/potassium/assets/README.yml

@@ -27,7 +27,7 @@ readme:
       body: |
         For hot-reloading and fast webpacker compilation you need to run webpack's dev server along with the rails server:
 
-            $ ./bin/webpack-dev-server
+            $ ./bin/webpacker-dev-server
 
         Running the dev server will also solve problems with the cache not refreshing between changes and provide better error messages if something fails to compile.
 
@@ -105,7 +105,34 @@ readme:
           body: "For managing uploads, this project uses [Active Storage](https://github.com/rails/rails/tree/master/activestorage)."
         shrine:
           title: "File Storage"
-          body: "For managing uploads, this project uses [Shrine](https://github.com/shrinerb/shrine)."
+          body: |
+            For managing uploads, this project uses [Shrine](https://github.com/shrinerb/shrine). When generated, this project includes the following files and configurations:
+
+            - `ImageUploader` that includes file type validation
+            - `CoverImageUploader`, inheriting from `ImageUploader`. It does a couple of things:
+              - Generates derivatives in `jpg` and `webp` format, for three different sizes. For an attachment of name `image`, to get the url for a derivative, let's say `sm`, you would do `record.image_url(:sm)`
+              - Saves a [blurhash](https://blurha.sh/) code to the attachment metadata
+            - `ImageHandlingUtilities`, a shrine plugin in the initializers folder that is used in the `CoverImageUploader`. Given a model with an attachment of name `image`, it adds the following methods to the model:
+              - `image_blurhash`: returns blurhash from metadata
+              - `generate_image_derivatives`: It generates all derivatives defined in Uploader. If file already had derivatives, it replaces them with newly generated ones. Associated class method: `generate_all_image_derivatives`
+              - `generate_image_metadata`: refreshes all metadata for attachment. Associated class method: `generate_all_image_metadata`
+              - `generate_image_derivatives_and_metadata`: does both previous things. Useful because it does so opening the file only once. Associated class method: `generate_all_image_derivatives_and_metadata`
+
+              Class methods are the same as their instance counterparts, but for collections. They also allow error handling on an individual record by passing a block to handle each error. If no block is given, attachments that throw errors are ignored and the iteration continues
+            - `ImageHandlingAttributes` serializer concern. It adds a method `add_image_handling_attributes` to all serializers that inherit from `BaseSerializer`. Considering an attachment of name `image`, this method adds two attributes to the serialized record:
+              - `image_blurhash`
+              - `image`. This is a hash that includes urls for all derivatives passed to the method. For example:
+              ```
+                add_image_handling_attributes(attachment_name: :image, derivatives: [:sm, :md], include_original_image: true)
+
+                # results in the following hash for the image attribute:
+                # {
+                #   sm: { url: 'someurl.com/bla' },
+                #   md: { url: 'someurl.com/ble' },
+                #   original: { url: 'someurl.com/ble' }
+                # }
+              ```
+            - `SHRINE_SECRET_KEY` environment variable. It comes witha value set in `.env.development`, but you'll need to set one for it in staging and production. It can be any random value, generating it with `SecureRandom.hex` for instance
         pundit:
           title: "Authorization"
           body: "For defining which parts of the system each user has access to, we have chosen to include the [Pundit](https://github.com/elabs/pundit) gem, by [Elabs](http://elabs.se/)."
@@ -123,20 +150,17 @@ readme:
           body: "This project uses [Draper](https://github.com/drapergem/draper) to add an object-oriented layer of presentation logic"
         power_types:
           title: "Rails pattern enforcing types"
-          body: "This projects uses [Power-Types](https://github.com/platanus/power-types) to generate Services, Commands, Utils and Values."
+          body: "This project uses [Power-Types](https://github.com/platanus/power-types) to generate Services, Commands, Utils and Values."
         power_api:
           title: "API Support"
           body: "This projects uses [Power API](https://github.com/platanus/power_api). It's a Rails engine that gathers a set of gems and configurations designed to build incredible REST APIs."
-        graphql:
-          title: "API Support"
-          body: "This projects uses [graphql-ruby](https://graphql-ruby.org/) to generate a GraphQL API."
         active_admin:
           title: "Administration"
           body: |
             This project uses [Active Admin](https://github.com/activeadmin/activeadmin) which is a Ruby on Rails framework for creating elegant backends for website administration.
             <% if get(:vue_admin) %>
             This project supports Vue inside ActiveAdmin
-            - The main package is located in `app/javascript/packs/admin_application.js`, here you will declare the components you want to include in your ActiveAdmin views as you would in a normal Vue App.
+            - The main package is located in `app/javascript/active_admin.js`, here you will declare the components you want to include in your ActiveAdmin views as you would in a normal Vue App.
             - Additionally, to be able to use Vue components as [Arbre](https://github.com/activeadmin/arbre) Nodes the component names are also declared in `config/initializers/active_admin.rb`
             - The generator includes an example component called `admin_component`, you can use this component inside any ActiveAdmin view by just writing `admin_component` as you would with any `html` tag.
               - For example:
@@ -153,8 +177,51 @@ readme:
               ```
               - You can also use **any** vue bindings such as `v-for` , `:key` etc.
             <% end %>
+            <% if get(:authorization) %>
+            It uses the [ActiveAdmin's Pundit adapter](https://activeadmin.info/13-authorization-adapter.html).
+            - Policies for admin resources must inherit from `BackOffice::DefaultPolicy` and be placed inside the `app/policies/back_office` directory.
+              - For example:
+
+                `app/admin/clients.rb`:
+
+                ```ruby
+                ActiveAdmin.register Client do
+                  # ...
+                end
+                ```
+
+                `app/policies/back_office/client_policy.rb`:
+
+                ```ruby
+                class BackOffice::ClientPolicy < BackOffice::DefaultPolicy
+                end
+                ```
+            <% end %>
     seeds:
       title: "Seeds"
       body: |
         To populate your database with initial data you can add, inside the `/db/seeds.rb` file, the code to generate **only the necessary data** to run the application.
         If you need to generate data with **development purposes**, you can customize the `lib/fake_data_loader.rb` module and then to run the `rake load_fake_data` task from your terminal.
+    testing:
+      title: "Testing"
+      body: |
+        We use:
+        - [RSpec](https://github.com/rspec/rspec-rails): the testing framework.
+        - [Shoulda Matchers](https://github.com/thoughtbot/shoulda-matchers): one-liners to test common Rails functionality that, if written by hand, would be much longer, more complex, and error-prone.
+        - [Factory Bot](https://github.com/thoughtbot/factory_bot_rails): a fixtures replacement with a straightforward definition syntax, support for multiple build strategies (saved instances, unsaved instances, attribute hashes, and stubbed objects), and support for multiple factories for the same class (user, admin_user, and so on), including factory inheritance.
+        - [Faker](https://github.com/faker-ruby/faker): a port of Perl's Data::Faker library that generates fake data.
+        - [Guard](https://github.com/guard/guard): automates various tasks by running custom rules whenever file or directories are modified. We use it to run RSpec when files change.
+
+        Place your unit tests inside the `spec` directory.
+
+        To run unit tests: `bin/guard`
+
+        #### System tests
+
+        We use, in addition to the previous gems:
+        - [Capybara](https://github.com/teamcapybara/capybara): helps you test web applications by simulating how a real user would interact with your app. It is agnostic about the driver running your tests and comes with Rack::Test and Selenium support built in. WebKit is supported through an external gem.
+        - [Webdrivers](https://github.com/titusfortner/webdrivers): run Selenium tests more easily with automatic installation and updates for all supported webdrivers.
+
+        Place your system tests inside the `spec/system` directory.
+
+        To run system tests: `bin/rspec --tag type:system`

data/lib/potassium/assets/active_admin/admin-component.vue

@@ -1,35 +1,27 @@
+<script setup lang="ts">
+interface Props {
+  test?: string
+  testNumber?: number
+  testObject?: {[key: string]: string},
+  testList?: number[],
+}
+
+const props = withDefaults(
+  defineProps<Props>(),
+  {
+    test: undefined,
+    testNumber: 0,
+    testObject: undefined,
+    testList: undefined,
+  },
+);
+
+const message = 'Hello World';
+</script>
+
 <template>
   <div>
-    I am a Vue Component {{ test }} {{ message }}
+    I am a Vue Component {{ props.test }} {{ message }}
     <slot />
   </div>
 </template>
-
-<script>
-export default {
-  props: {
-    test: {
-      type: String,
-      default: '',
-    },
-    testNumber: {
-      type: Number,
-      default: 0,
-    },
-    testObject: {
-      type: Object,
-      default: null,
-    },
-    testList: {
-      type: Array,
-      default: null,
-    },
-  },
-
-  data() {
-    return {
-      message: 'Hello World',
-    };
-  },
-};
-</script>

data/lib/potassium/assets/active_admin/policies/admin_user_policy.rb

@@ -0,0 +1,2 @@
+class BackOffice::AdminUserPolicy < BackOffice::DefaultPolicy
+end

data/lib/potassium/assets/active_admin/policies/comment_policy.rb

@@ -0,0 +1,2 @@
+class BackOffice::ActiveAdmin::CommentPolicy < BackOffice::DefaultPolicy
+end

data/lib/potassium/assets/active_admin/policies/default_policy.rb

@@ -0,0 +1,49 @@
+class BackOffice::DefaultPolicy
+  attr_reader :admin_user, :record
+
+  def initialize(admin_user, record)
+    @admin_user = admin_user
+    @record = record
+  end
+
+  def index?
+    true
+  end
+
+  def show?
+    true
+  end
+
+  def create?
+    true
+  end
+
+  def new?
+    create?
+  end
+
+  def update?
+    true
+  end
+
+  def edit?
+    update?
+  end
+
+  def destroy?
+    true
+  end
+
+  class Scope
+    attr_reader :admin_user, :scope
+
+    def initialize(admin_user, scope)
+      @admin_user = admin_user
+      @scope = scope
+    end
+
+    def resolve
+      scope.all
+    end
+  end
+end

data/lib/potassium/assets/active_admin/policies/page_policy.rb

@@ -0,0 +1,2 @@
+class BackOffice::ActiveAdmin::PagePolicy < BackOffice::DefaultPolicy
+end

data/lib/potassium/assets/app/javascript/{app.spec.js → components/app.spec.ts}

@@ -1,10 +1,10 @@
 import { shallowMount } from '@vue/test-utils';
-import App from 'app';
+import App from './app.vue';
 
 describe('App', () => {
   test('is a Vue instance', () => {
     const wrapper = shallowMount(App);
-    expect(wrapper.isVueInstance()).toBeTruthy();
+    expect(wrapper.vm).toBeTruthy();
   });
 
   it('displays message on load', () => {

data/lib/potassium/assets/app/javascript/components/app.vue

@@ -0,0 +1,9 @@
+<script setup lang="ts">
+const message = 'Hello Vue!';
+</script>
+
+<template>
+  <div id="app">
+    <p class="text-center text-lg">{{ message }}</p>
+  </div>
+</template>

data/lib/potassium/assets/app/javascript/types/vue.d.ts

@@ -0,0 +1,5 @@
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<{}, {}, any>
+  export default component
+}

data/lib/potassium/assets/app/jobs/shrine_promote_job.rb

@@ -0,0 +1,14 @@
+class ShrinePromoteJob < ApplicationJob
+  queue_as :default
+
+  def perform(attacher_class, record_class, record_id, name, file_data)
+    attacher_class = Object.const_get(attacher_class)
+    record         = Object.const_get(record_class).find(record_id)
+
+    attacher = attacher_class.retrieve(model: record, name: name, file: file_data)
+    attacher.create_derivatives
+    attacher.atomic_promote
+  rescue Shrine::AttachmentChanged, ActiveRecord::RecordNotFound
+    # attachment has changed or the record has been deleted, nothing to do
+  end
+end

data/lib/potassium/assets/app/mailers/application_mailer.rb

@@ -1,3 +1,3 @@
 class ApplicationMailer < ActionMailer::Base
-  layout 'mailer'
+  layout 'default_mail'
 end

data/lib/potassium/assets/app/mailers/example_mailer.rb

@@ -0,0 +1,6 @@
+class ExampleMailer < ApplicationMailer
+  def example_mail
+    @email = params[:email]
+    mail(from: 'admin@example.com', to: @email, subject: 'Welcome to Potassium')
+  end
+end