shakapacker 6.5.4 → 7.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57e24ac7fbe67a903f0a5f0d6725544b37b2c8a1bae324cd487642e69a525b8d
-  data.tar.gz: 704a88906fec3e37ec10b2b5cce8fd3ea8ad2c1a556e5badc89aef887d7c02cc
+  metadata.gz: 51bc05e46de3c757f9d47e0435cb1928759bff38a354b4b63a5e28f5fe91b1c6
+  data.tar.gz: a21060c6cd736a1171c78d1bdd927292523148cedccb90e361a4c645be05983e
 SHA512:
-  metadata.gz: 918d57502a80582726426833b6a6a57848ab771c9d7acb1d2ab5748b3d5407a4ee44c6ece9849ee2db2879d3329761577678377aaccc1f67ce6a6fd72f3d5e38
-  data.tar.gz: ac9f9397b1922969a360d8c8963a3ba298eea656ae5eca1925ed419788fa40ae3d3f17d2cc8ddacb459c23cadfe2ba67cbf7827b8b9e499f52e59694cf59253f
+  metadata.gz: eb9e323ebfcc603375ab766b3b2fc87641379e40a18f033703d4b0e1887001d7e7a915f42359a71d307b651f0de2e15e7cb209ccb7d40ccbfd3d839e2436e0ad
+  data.tar.gz: c839ce0d465e2fa67379938264de5da4e00f9374202b2e13a36e3f1e6943dde73f80304f9e88f49632a8944ddc2238ea96a81136e609ed16873ce8e06c2cca01

data/.eslintrc.js

@@ -5,6 +5,7 @@ module.exports = {
     'import/no-unresolved': 'off',
     'import/no-extraneous-dependencies': 'off',
     'import/extensions': 'off',
+    "indent": ["error", 2],
     semi: ['error', 'never']
   },
   env: {

data/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [shakacode]

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -7,14 +7,18 @@ assignees: ''
 
 ---
 
-A bug is a crash or incorrect behavior. If you have a debugging or troubleshooting question, please open a discussion on [Discussions Tab](https://github.com/shakacode/shakapacker/discussions).
+_Notice: A bug is a crash or incorrect behavior. If you have a debugging or troubleshooting question, please open a discussion on the [Discussions Tab](https://github.com/shakacode/shakapacker/discussions). Otherwise, remove this line and fill out the following sections._
 
-Ruby version:
-Rails version:
-Shakapacker version:
+## Expected behavior:
 
-Expected behavior:
 
-Actual behavior:
+## Actual behavior:
 
-Small, reproducible repo:
+
+## Small, reproducible repo:
+
+
+## Setup environment:
+- Ruby version: 
+- Rails version: 
+- Shakapacker version: 

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature request
+about: Create a request for new functionality
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+_Notice: A feature request describes a suggested improvement. If you have a debugging or troubleshooting question, please open a discussion on the [Discussions Tab](https://github.com/shakacode/shakapacker/discussions). Otherwise, remove this line and fill out the following sections._
+
+## Desired behavior:
+
+
+## Actual behavior:
+
+
+## Setup environment:
+- Ruby version: 
+- Rails version: 
+- Shakapacker version: 

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+### Summary
+
+_Remove this paragraph and describe the code changes in your pull request... were there any bugs you had fixed? If so, mention them. If these bugs have open GitHub issues, tag them here as well to keep the conversation linked._
+
+### Pull Request checklist
+_Remove this line after checking all the items here. If the item does not apply to the PR, both check it out and wrap it by `~`._
+
+- [ ] Add/update test to cover these changes
+- [ ] Update documentation
+- [ ] Update CHANGELOG file
+
+### Other Information
+
+_Remove this paragraph and mention other important and relevant information, such as benchmarks._

data/.github/workflows/dummy.yml

@@ -0,0 +1,21 @@
+name: Dummy specs
+
+on: [push]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.1.2'
+      - name: Install dependencies
+        run: |
+          bundle install
+          yarn install
+          sudo yarn global add yalc
+
+      - name: Run tests
+        run: bundle exec rake run_spec:dummy

data/.github/workflows/generator.yml

@@ -0,0 +1,37 @@
+name: Generator specs
+
+on: [push]
+
+jobs:
+  test:
+    name: Generator specs
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        ruby: ['2.6', '2.7', '3.0']
+        gemfile:
+          - gemfiles/Gemfile-rails.6.0.x
+          - gemfiles/Gemfile-rails.6.1.x
+          - gemfiles/Gemfile-rails.7.0.x
+          # Uncomment the following line only to ensure compatibility with the
+          # upcomming Rails versions, maybe before a release.
+          #- gemfiles/Gemfile-rails-edge
+        exclude:
+          - ruby: 2.6
+            os: ubuntu-latest
+            gemfile: gemfiles/Gemfile-rails.7.0.x
+          - ruby: 2.6
+            os: ubuntu-latest
+            gemfile: gemfiles/Gemfile-rails-edge
+    env:
+      BUNDLE_GEMFILE: ${{ matrix.gemfile }}
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - name: Install dependencies
+        run: bundle install
+      - run: bundle exec rake run_spec:generator

data/.github/workflows/jest.yml

@@ -1,6 +1,6 @@
 name: Jest specs
 
-on: [push, pull_request]
+on: [push]
 
 jobs:
   jest:
@@ -8,7 +8,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        node: [12.x, 14.x, 16.x]
+        node: [14.x, 16.x, 18.x]
 
     runs-on: ${{ matrix.os }}
 

data/.github/workflows/js-lint.yml

@@ -1,6 +1,6 @@
 name: JS lint
 
-on: [push, pull_request]
+on: [push]
 
 jobs:
   lint:
@@ -8,7 +8,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        node: [12.x, 14.x, 16.x]
+        node: [14.x, 16.x, 18.x]
 
     runs-on: ${{ matrix.os }}
 

data/.github/workflows/rubocop.yml

@@ -1,6 +1,6 @@
 name: Rubocop
 
-on: [push, pull_request]
+on: [push]
 
 jobs:
   rubocop:

data/.github/workflows/ruby-backward-compatibility.yml

@@ -0,0 +1,39 @@
+name: Ruby specs - Backward compatibility
+
+on: [push]
+
+jobs:
+  test:
+    name: Ruby specs - Backward compatibility
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        ruby: ['2.6', '2.7', '3.0']
+        gemfile:
+          - gemfiles/Gemfile-rails.6.0.x
+          - gemfiles/Gemfile-rails.6.1.x
+          - gemfiles/Gemfile-rails.7.0.x
+          # Uncomment the following line only to ensure compatibility with the
+          # upcomming Rails versions, maybe before a release.
+          #- gemfiles/Gemfile-rails-edge
+        exclude:
+          - ruby: 2.6
+            os: ubuntu-latest
+            gemfile: gemfiles/Gemfile-rails.7.0.x
+          - ruby: 2.6
+            os: ubuntu-latest
+            gemfile: gemfiles/Gemfile-rails-edge
+
+    env:
+      BUNDLE_GEMFILE: ${{ matrix.gemfile }}
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: Ruby specs - Backward compatibility
+        run: bundle exec rake run_spec:gem_bc

data/.github/workflows/ruby.yml

@@ -1,6 +1,6 @@
 name: Ruby specs
 
-on: [push, pull_request]
+on: [push]
 
 jobs:
   test:
@@ -11,11 +11,12 @@ jobs:
         os: [ubuntu-latest]
         ruby: ['2.6', '2.7', '3.0']
         gemfile:
-          - gemfiles/Gemfile-rails.5.2.x
           - gemfiles/Gemfile-rails.6.0.x
           - gemfiles/Gemfile-rails.6.1.x
           - gemfiles/Gemfile-rails.7.0.x
-          - gemfiles/Gemfile-rails-edge
+          # Uncomment the following line only to ensure compatibility with the
+          # upcomming Rails versions, maybe before a release.
+          #- gemfiles/Gemfile-rails-edge
         exclude:
           - ruby: 2.6
             os: ubuntu-latest
@@ -23,9 +24,6 @@ jobs:
           - ruby: 2.6
             os: ubuntu-latest
             gemfile: gemfiles/Gemfile-rails-edge
-          - ruby: 3.0
-            os: ubuntu-latest
-            gemfile: gemfiles/Gemfile-rails.5.2.x
 
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
@@ -38,4 +36,4 @@ jobs:
           bundler-cache: true
 
       - name: Ruby specs
-        run: bundle exec rake test
+        run: bundle exec rake run_spec:gem_bc

data/.gitignore

@@ -1,14 +1,17 @@
 /.bundle
 Gemfile.lock
 /pkg
-/test/mounted_app/test/dummy/log
-/test/test_app/log
+/spec/mounted_app/test/dummy/log
+/spec/test_app/log
 node_modules
 .byebug_history
-/test/test_app/tmp
+/spec/test_app/tmp
 yarn-debug.log*
 yarn-error.log*
 .yarn-integrity
 /log
 gemfiles/*.lock
 .DS_Store
+
+.yalc
+yalc.lock

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/CHANGELOG.md

@@ -1,4 +1,5 @@
 * For the changelog of versions prior to v6, see the [5.x stable branch of rails/webpacker](https://github.com/rails/webpacker/tree/5-x-stable).
+* Please see the [v7 Upgrade Guide](./docs/v7_upgrade.md) for upgrading to new spelling in version 7.
 * Please see the [v6 Upgrade Guide](./docs/v6_upgrade.md) to go from versions prior to v6.
 * [ShakaCode](https://www.shakacode.com) offers support for upgrading from Webpacker or using Shakapacker. If interested, contact Justin Gordon, [justin@shakacode.com](mailto:justin@shakacode.com).
 
@@ -8,6 +9,81 @@ Changes since last non-beta release.
 
 _Please add entries here for your pull requests that are not yet released._
 
+### Fixed
+- Fixed creation of assets:precompile if it is missing [PR 325](https://github.com/shakacode/shakapacker/pull/325) by [ahangarha](https://github.com/ahangarha).
+
+## [v7.0.1] - June 27, 2023
+### Fixed
+- Fixed the condition for showing warning for setting `useContentHash` to `false` in the production environment. [PR 320](https://github.com/shakacode/shakapacker/pull/320) by [ahangarha](https://github.com/ahangarha).
+
+## [v7.0.0] - June 23, 2023
+### Breaking changes
+- Removes defaults passed to `@babel/preset-typescript`. [PR 273](https://github.com/shakacode/shakapacker/pull/273) by [tomdracz](https://github.com/tomdracz).
+
+  `@babel/preset-typescript` has been initialised in default configuration with `{ allExtensions: true, isTSX: true }` - meaning every file in the codebase was treated as TSX leading to potential issues. This has been removed and returns to sensible default of the preset which is to figure out the file type from the extensions. This change might affect generated output however so it is marked as breaking.
+
+- Export immutable webpackConfig function. [PR 293](https://github.com/shakacode/shakapacker/pull/293) by [tomdracz](https://github.com/tomdracz).
+
+  The `webpackConfig` property in the `shakapacker` module has been updated to be a function instead of a global mutable webpack configuration. This function now returns an immutable webpack configuration object, which ensures that any modifications made to it will not affect any other usage of the webpack configuration. If a project still requires the old mutable object, it can be accessed by replacing `webpackConfig` with `globalMutableWebpackConfig`. Check [v7-upgrade](https://github.com/shakacode/shakapacker/blob/master/docs/v7_upgrade.md) documentation for more detail.
+
+### Added
+- Set CSS modules mode depending on file type. [PR 261](https://github.com/shakacode/shakapacker/pull/261) by [talyuk](https://github.com/talyuk).
+- All standard webpack entries with the camelCase format are now supported in `shakapacker.yml` in snake_case format. [PR276](https://github.com/shakacode/shakapacker/pull/276) by [ahangarha](https://github.com/ahangarha).
+- The `shakapacker:install` rake task now has an option to force overriding files using `FORCE=true` environment variable [PR311](https://github.com/shakacode/shakapacker/pull/311) by [ahangarha](https://github.com/ahangarha).
+- Allow configuration of use of contentHash for specific environment [PR 234](https://github.com/shakacode/shakapacker/pull/234) by [justin808](https://github/justin808).
+
+### Changed
+- Rename Webpacker to Shakapacker in the entire project including config files, binstubs, environment variables, etc. with a high degree of backward compatibility.
+
+  This change might be breaking for certain setups and edge cases. More information: [v7 Upgrade Guide](./docs/v7_upgrade.md) [PR157](https://github.com/shakacode/shakapacker/pull/157) by [ahangarha](https://github.com/ahangarha)
+
+- Set `source_entry_path` to `packs` and `nested_entries` to `true` in`shakapacker.yml` [PR 284](https://github.com/shakacode/shakapacker/pull/284) by [ahangarha](https://github.com/ahangarha).
+- Dev server configuration is modified to follow [webpack recommended configurations](https://webpack.js.org/configuration/dev-server/) for dev server. [PR276](https://github.com/shakacode/shakapacker/pull/276) by [ahangarha](https://github.com/ahangarha):
+  - Deprecated `https` entry is removed from the default configuration file, allowing to set `server` or `https` as per the project requirements. For more detail, check webpack documentation. The `https` entry can be effective only if there is no `server` entry in the config file.
+  - `allowed_hosts` is now set to `auto` instead of `all` by default.
+
+- Remove the arbitrary stripping of the top-level directory when generating static file paths. [PR 283](https://github.com/shakacode/shakapacker/pull/283) by [tomdracz](https://github.com/tomdracz).
+
+  Prior to this change, top level directory of static assets like images and fonts was stripped. This meant that file in `app/javascript/images/image.png` would be output to `static/image.png` directory and could be referenced through helpers as `image_pack_tag("image.jpg")` or `image_pack_tag("static/image.jpg")`.
+
+  Going forward, the top level directory of static files will be retained so this will necessitate the update of file name references in asset helpers. In the example above, the file sourced from `app/javascript/images/image.png` will be now output to `static/images/image.png` and needs to be referenced as `image_pack_tag("images/image.jpg")` or `image_pack_tag("static/images/image.jpg")`.
+
+### Fixed
+- Move compilation lock file into the working directory. [PR 272](https://github.com/shakacode/shakapacker/pull/272) by [tomdracz](https://github.com/tomdracz).
+- Process `source_entry_path` with values starting with `/` as a relative path to `source_path` [PR 284](https://github.com/shakacode/shakapacker/pull/284) by [ahangarha](https://github.com/ahangarha).
+- Removes defaults passed to `@babel/preset-typescript` to make it possible to have projects with mix of JS and TS code [PR 273](https://github.com/shakacode/shakapacker/pull/273) by [tomdracz](https://github.com/tomdracz).
+
+  `@babel/preset-typescript` has been initialised in default configuration with `{ allExtensions: true, isTSX: true }` - meaning every file in the codebase was treated as TSX leading to potential issues. This has been removed and returns to sensible default of the preset which is to figure out the file type from the extensions. This change might affect generated output however so it is marked as breaking.
+
+- Fixed RC version detection during installation. [PR312](https://github.com/shakacode/shakapacker/pull/312) by [ahangarha](https://github.com/ahangarha)
+- Fix addition of webpack-dev-server to devDependencies during installation. [PR310](https://github.com/shakacode/shakapacker/pull/310) by [ahangarha](https://github.com/ahangarha)
+### Removed
+- Remove redundant enhancement for precompile task to run `yarn install` [PR 270](https://github.com/shakacode/shakapacker/pull/270) by [ahangarha](https://github.com/ahangarha).
+- Remove deprecated `check_yarn_integrity` from `Shakapacker::Configuration` [PR SP288](https://github.com/shakacode/shakapacker/pull/288) by [ahangarha](https://github.com/ahangarha).
+
+## [v6.6.0] - March 7, 2023
+### Improved
+- Allow configuration of webpacker.yml through env variable. [PR 254](https://github.com/shakacode/shakapacker/pull/254) by [alecslupu](https://github.com/alecslupu).
+
+## [v6.5.6] - February 11, 2023
+### Fixed
+- Fixed failing to update `bin/setup` file due to different formats of the file in different versions of Rails. [PR 229](https://github.com/shakacode/shakapacker/pull/229) by [ahangarha](https://github.com/ahangarha).
+
+- Upgrade several JS dependencies to fix security issues. [PR 243](https://github.com/shakacode/shakapacker/pull/243) by [ahangarha](https://github.com/ahangarha).
+
+- Added `prepend_javascript_pack_tag` to helpers. Allows to move an entry to the top of queue. Handy when calling from the layout to make sure an entry goes before the view and partial `append_javascript_pack_tag` entries. [PR 235](https://github.com/shakacode/shakapacker/pull/235) by [paypro-leon](https://github.com/paypro-leon).
+
+- Fixed [issue](https://github.com/shakacode/shakapacker/issues/208) to support directories under `node_modules/*` in the `additional_paths` property of `webpacker.yml` [PR 240](https://github.com/shakacode/shakapacker/pull/240) by [vaukalak](https://github.com/vaukalak).
+- Remove duplicate yarn installs. [PR 238](https://github.com/shakacode/shakapacker/pull/238) by [justin808](https://github/justin808).
+- Remove unneeded code related to CSP config for generator. [PR 223](https://github.com/shakacode/shakapacker/pull/223) by [ahangarha](https://github/ahangarha).
+
+## [v6.5.5] - December 28, 2022
+
+### Improved
+- Describe keys different from `webpack-dev-server` in generated `webpacker.yml`. [PR 194](https://github.com/shakacode/shakapacker/pull/194) by [alexeyr](https://github.com/alexeyr).
+- Allow webpack-cli v5 [PR 216](https://github.com/shakacode/shakapacker/pull/216) by [tagliala](https://github.com/tagliala).
+- Allow babel-loader v9 [PR 215](https://github.com/shakacode/shakapacker/pull/215) by [tagliala](https://github.com/tagliala).
+
 ## [v6.5.4] - November 4, 2022
 ### Fixed
 - Fixed regression caused by 6.5.3. PR #192 introduce extra split() call. [PR 202](https://github.com/shakacode/shakapacker/pull/202) by [Eric-Guo](https://github.com/Eric-Guo).
@@ -112,7 +188,7 @@ Note: [Rubygem is 6.3.0.pre.rc.1](https://rubygems.org/gems/shakapacker/versions
 - Make manifest_path configurable, to keep manifest.json private if desired. [PR 78](https://github.com/shakacode/shakapacker/pull/78) by [jdelStrother](https://github.com/jdelStrother).
 - Rewrite webpack module rules as regular expressions. Allows for easy iteration during config customization. [PR 60](https://github.com/shakacode/shakapacker/pull/60) by [blnoonan](https://github.com/blnoonan).
 - Initialization check to ensure shakapacker gem and NPM package version are consistent. Opt-in behaviour enabled by setting `ensure_consistent_versioning` configuration variable. [PR 51](https://github.com/shakacode/shakapacker/pull/51) by [tomdracz](https://github.com/tomdracz).
-- Add `dev_server.inline_css: bool` config option to allow for opting out of style-loader and into mini-extract-css-plugin for CSS HMR in development. [PR 69](https://github.com/shakacode/shakapacker/pull/69) by [cheald](https://github.com/cheald).
+- Add `dev_server.inline_css: bool` config option to allow for opting out of style-loader and into mini-css-extract-plugin for CSS HMR in development. [PR 69](https://github.com/shakacode/shakapacker/pull/69) by [cheald](https://github.com/cheald).
 
 ### Improved
 - Increase default connect timeout for dev server connections, establishing connections more reliably for busy machines. [PR 74](https://github.com/shakacode/shakapacker/pull/74) by [stevecrozz](https://github.com/stevecrozz).
@@ -186,7 +262,12 @@ Note: [Rubygem is 6.3.0.pre.rc.1](https://rubygems.org/gems/shakapacker/versions
 ## v5.4.3 and prior changes from rails/webpacker
 See [CHANGELOG.md in rails/webpacker (up to v5.4.3)](https://github.com/rails/webpacker/blob/master/CHANGELOG.md)
 
-[Unreleased]: https://github.com/shakacode/shakapacker/compare/v6.5.4...master
+[Unreleased]: https://github.com/shakacode/shakapacker/compare/v7.0.1...master
+[v7.0.1]: https://github.com/shakacode/shakapacker/compare/v7.0.0...v7.0.1
+[v7.0.0]: https://github.com/shakacode/shakapacker/compare/v6.6.0...v7.0.0
+[v6.6.0]: https://github.com/shakacode/shakapacker/compare/v6.5.6...v6.6.0
+[v6.5.6]: https://github.com/shakacode/shakapacker/compare/v6.5.5...v6.5.6
+[v6.5.5]: https://github.com/shakacode/shakapacker/compare/v6.5.4...v6.5.5
 [v6.5.4]: https://github.com/shakacode/shakapacker/compare/v6.5.3...v6.5.4
 [v6.5.3]: https://github.com/shakacode/shakapacker/compare/v6.5.2...v6.5.3
 [v6.5.2]: https://github.com/shakacode/shakapacker/compare/v6.5.1...v6.5.2

data/CONTRIBUTING.md

@@ -1,19 +1,60 @@
-## Setting Up a Development Environment
+# Contributing Guidelines
 
-1. Install [Yarn](https://yarnpkg.com/)
+Thank you for your interest in contributing to Shakapacker! We welcome all contributions that align with our project goals and values. To ensure a smooth and productive collaboration, please follow these guidelines.
 
-2. Run the following commands to set up the development environment.
+## Contents
+- [Reporting Issues](#reporting-issues)
+- [Submitting Pull Requests](#submitting-pull-requests)
+- [Setting Up a Development Environment](#setting-up-a-development-environment)
+- [Making sure your changes pass all tests](#making-sure-your-changes-pass-all-tests)
+- [Testing the generator](#testing-the-generator)
 
-```
-bundle install
-yarn
-```
+## Reporting Issues
+If you encounter any issues with the project, please first check the exisiting issues (including closed ones). If the issues is not reported before, please opening an issue on our GitHub repository. Please provide a clear and detailed description of the issue, including steps to reproduce it. Creating a demo repository to demonstrate the issue would be ideal (and in some cases necessary).
+
+If looking to contribute to the project by fixing existing issues, we recommend looking at issues, particularly with the "[help wanted](https://github.com/shakacode/shakapacker/issues?q=is%3Aissue+label%3A%22help+wanted%22)" label.
+
+## Submitting Pull Requests
+We welcome pull requests that fix bugs, add new features, or improve existing ones. Before submitting a pull request, please make sure to:
+
+  - Open an issue about what you want to propose before start working on.
+  - Fork the repository and create a new branch for your changes.
+  - Write clear and concise commit messages.
+  - Follow our code style guidelines.
+  - Write tests for your changes and [make sure all tests pass](#making-sure-your-changes-pass-all-tests).
+  - Update the documentation as needed.
+  - Update CHANGELOG.md if the changes affect public behavior of the project.
+
+---
+## Setting Up a Development Environment
+
+1. Install [Yarn](https://classic.yarnpkg.com/)
+2. To test your changes on a Rails test project do the following steps:
+   - For Ruby gem, update `Gemfile` and point the `shakapacker` to the locally developing Shakapacker project:
+      ```ruby
+      gem 'shakapacker', path: "relative_or_absolute_path_to_local_shakapacker"
+      ```
+   - For npm package, use `yalc` with following steps:
+      ```bash
+      # In Shakapacker root directory
+      yalc publish
+      # In Rails app for testing
+      yalc link shakapacker
+
+      # After every chagnes in shakapacker, run the folloing in Shakapacker directory
+      yalc push # or yalc publish --push
+      ```
+3. Run the following commands to set up the development environment.
+   ```
+   bundle install
+   yarn install
+   ```
 
 ## Making sure your changes pass all tests
 
-There are a number of automated checks which run on GitHub Actions when a pull request is created.
+There are several specs, covering different aspects of Shakapacker gem. You may run them locally or rely on GitHub CI actions configured to test the gem functionality if different Ruby, Rails, and Node environment.
 
-You can run those checks on your own locally to make sure that your changes would not break the CI build.
+We request running tests locally to ensure the new changes would not break the CI build.
 
 ### 1. Check the code for JavaScript style violations
 
@@ -33,30 +74,55 @@ bundle exec rubocop
 yarn test
 ```
 
-### 4. Run the Ruby test suite
+### 4. Run all the Ruby test suite
 
 ```
 bundle exec rake test
 ```
 
+Note: For this, you need `yalc` to be installed on your local machine
+
 #### 4.1 Run a single ruby test file
 
 ```
-bundle exec rake test TEST=test/rake_tasks_test.rb
+bundle exec rspec spec/configuration_spec.rb
 ```
 
 #### 4.2 Run a single ruby test
 
 ```
-bundle exec ruby -I test test/rake_tasks_test.rb -n test_rake_webpacker_install
+bundle exec rspec -e "#source_entry_path returns correct path"
+```
+
+#### 4.3 Run only Shakapacker gem specs
+
+```
+bundle exec rake run_spec:gem
+```
+
+#### 4.4 Run only Shakapacker gem specs for backward compatibility
+These specs are to check Shakapcker v7 backward compatibility with v6.x
+
+```
+bundle exec rake run_spec:gem_bc
 ```
 
-# Testing the generator
-If you change the generator, check that install instructions work.
+#### 4.5 Run dummy app test
+For this, you need `yalc` to be installed on your local machine
 
-1. Update the gemfile so that gem "webpacker" has a line like this, pointing to your install of webpacker
+```
+bundle exec rake run_spec:dummy
+```
+
+#### 4.6 Testing the installer
+To ensure that your installer works as expected, either you can run `bundle exec rake run_spec:install`, or take the following manual testing steps:
+
+1. Update the `Gemfile` so that gem `shakapacker` has a line like this, pointing to your developing Shakapacker:
    ```ruby
-   gem 'webpacker', path: "~/shakacode/forks/shakapacker"
+   gem 'shakapacker', path: "relative_or_absolute_path_to_the_gem"
    ```
-2. `bundle`
-3. Run the generator confirm that you got the right changes. 
+2. Run `bundle install` to install the updated gem.
+3. Run `bundle exec rails shakapacker:install` to confirm that you got the right changes.
+
+ **Note:** Ensure that you use bundle exec otherwise the installed shakapacker gem will run and not the one you are working on.
+

data/Gemfile.development_dependencies

@@ -6,8 +6,10 @@ gem "rack-proxy", ">= 0.7.2"
 gem "nokogiri", ">= 1.13.6"
 gem "rails-html-sanitizer", ">= 1.4.3"
 
+group :test, :development do
+  gem "rspec-rails", "~> 6.0.2"
+end
 
 group :test do
-  gem "minitest", "~> 5.0"
   gem "byebug"
 end