react_on_rails 13.3.5 → 14.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (146) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +100 -62
  3. data/Gemfile.development_dependencies +10 -9
  4. data/README.md +7 -2
  5. data/lib/generators/react_on_rails/adapt_for_older_shakapacker_generator.rb +41 -0
  6. data/lib/generators/react_on_rails/base_generator.rb +13 -49
  7. data/lib/generators/react_on_rails/dev_tests_generator.rb +1 -1
  8. data/lib/generators/react_on_rails/generator_messages.rb +40 -0
  9. data/lib/generators/react_on_rails/install_generator.rb +21 -0
  10. data/lib/generators/react_on_rails/templates/base/base/Procfile.dev +2 -2
  11. data/lib/generators/react_on_rails/templates/base/base/Procfile.dev-static +2 -2
  12. data/lib/generators/react_on_rails/templates/base/base/config/initializers/react_on_rails.rb +2 -2
  13. data/lib/generators/react_on_rails/templates/base/base/config/{webpacker.yml → shakapacker.yml} +3 -3
  14. data/lib/generators/react_on_rails/templates/base/base/config/webpack/commonWebpackConfig.js.tt +3 -1
  15. data/lib/generators/react_on_rails/templates/dev_tests/spec/rails_helper.rb +2 -2
  16. data/lib/generators/react_on_rails/templates/dev_tests/spec/system/hello_world_spec.rb +1 -1
  17. data/lib/react_on_rails/configuration.rb +39 -25
  18. data/lib/react_on_rails/git_utils.rb +3 -3
  19. data/lib/react_on_rails/helper.rb +25 -13
  20. data/lib/react_on_rails/json_output.rb +0 -17
  21. data/lib/react_on_rails/locales/base.rb +4 -4
  22. data/lib/react_on_rails/locales/to_js.rb +1 -1
  23. data/lib/react_on_rails/packs_generator.rb +4 -4
  24. data/lib/react_on_rails/react_component/render_options.rb +1 -1
  25. data/lib/react_on_rails/server_rendering_pool/ruby_embedded_java_script.rb +10 -12
  26. data/lib/react_on_rails/test_helper/webpack_assets_status_checker.rb +3 -3
  27. data/lib/react_on_rails/test_helper.rb +2 -2
  28. data/lib/react_on_rails/utils.rb +2 -8
  29. data/lib/react_on_rails/version.rb +1 -1
  30. data/lib/react_on_rails/version_checker.rb +2 -2
  31. data/lib/react_on_rails/webpacker_utils.rb +6 -0
  32. data/lib/tasks/assets.rake +1 -1
  33. data/react_on_rails.gemspec +4 -4
  34. metadata +6 -131
  35. data/.bookignore +0 -15
  36. data/.circleci/config.yml +0 -338
  37. data/.coveralls.yml +0 -1
  38. data/.dockerignore +0 -2
  39. data/.eslintignore +0 -17
  40. data/.eslintrc +0 -53
  41. data/.github/FUNDING.yml +0 -1
  42. data/.github/ISSUE_TEMPLATE/bug_report.md +0 -23
  43. data/.github/ISSUE_TEMPLATE/feature_request.md +0 -20
  44. data/.github/PULL_REQUEST_TEMPLATE.md +0 -19
  45. data/.github/workflows/lint-js-and-ruby.yml +0 -54
  46. data/.github/workflows/main.yml +0 -183
  47. data/.github/workflows/package-js-tests.yml +0 -35
  48. data/.github/workflows/rspec-package-specs.yml +0 -46
  49. data/.gitignore +0 -33
  50. data/.npmignore +0 -22
  51. data/.prettierignore +0 -14
  52. data/.prettierrc +0 -20
  53. data/.rspec +0 -2
  54. data/.rubocop.yml +0 -134
  55. data/.scss-lint.yml +0 -205
  56. data/.travis.yml +0 -61
  57. data/book.json +0 -18
  58. data/docs/additional-details/generator-details.md +0 -56
  59. data/docs/additional-details/manual-installation-overview.md +0 -30
  60. data/docs/additional-details/migrating-from-react-rails.md +0 -17
  61. data/docs/additional-details/recommended-project-structure.md +0 -69
  62. data/docs/additional-details/updating-dependencies.md +0 -31
  63. data/docs/additional-details/upgrade-webpacker-v3-to-v4.md +0 -10
  64. data/docs/api/javascript-api.md +0 -99
  65. data/docs/api/redux-store-api.md +0 -102
  66. data/docs/api/view-helpers-api.md +0 -133
  67. data/docs/contributor-info/errors-with-hooks.md +0 -45
  68. data/docs/contributor-info/generator-testing.md +0 -11
  69. data/docs/contributor-info/linters.md +0 -68
  70. data/docs/contributor-info/pull-requests.md +0 -42
  71. data/docs/contributor-info/releasing.md +0 -76
  72. data/docs/deployment/elastic-beanstalk.md +0 -63
  73. data/docs/deployment/heroku-deployment.md +0 -35
  74. data/docs/getting-started.md +0 -195
  75. data/docs/guides/client-vs-server-rendering.md +0 -27
  76. data/docs/guides/configuration.md +0 -289
  77. data/docs/guides/deployment.md +0 -5
  78. data/docs/guides/file-system-based-automated-bundle-generation.md +0 -205
  79. data/docs/guides/hmr-and-hot-reloading-with-the-webpack-dev-server.md +0 -104
  80. data/docs/guides/how-react-on-rails-works.md +0 -44
  81. data/docs/guides/how-to-conditionally-server-render-based-on-device-type.md +0 -40
  82. data/docs/guides/how-to-use-different-files-for-client-and-server-rendering.md +0 -98
  83. data/docs/guides/i18n.md +0 -87
  84. data/docs/guides/installation-into-an-existing-rails-app.md +0 -66
  85. data/docs/guides/minitest-configuration.md +0 -31
  86. data/docs/guides/rails-webpacker-react-integration-options.md +0 -213
  87. data/docs/guides/react-on-rails-overview.md +0 -30
  88. data/docs/guides/react-server-rendering.md +0 -32
  89. data/docs/guides/render-functions-and-railscontext.md +0 -205
  90. data/docs/guides/rspec-configuration.md +0 -73
  91. data/docs/guides/tutorial.md +0 -374
  92. data/docs/guides/upgrading-react-on-rails.md +0 -304
  93. data/docs/guides/webpack-configuration.md +0 -42
  94. data/docs/home.md +0 -23
  95. data/docs/javascript/angular-js-integration-migration.md +0 -28
  96. data/docs/javascript/asset-pipeline.md +0 -12
  97. data/docs/javascript/capistrano-deployment.md +0 -18
  98. data/docs/javascript/code-splitting.md +0 -165
  99. data/docs/javascript/converting-from-custom-webpack-config-to-rails-webpacker-config.md +0 -10
  100. data/docs/javascript/credits.md +0 -10
  101. data/docs/javascript/foreman-issues.md +0 -15
  102. data/docs/javascript/images.md +0 -57
  103. data/docs/javascript/node-dependencies-and-npm.md +0 -19
  104. data/docs/javascript/react-and-redux.md +0 -36
  105. data/docs/javascript/react-helmet.md +0 -100
  106. data/docs/javascript/react-router.md +0 -90
  107. data/docs/javascript/server-rendering-tips.md +0 -55
  108. data/docs/javascript/troubleshooting-when-using-webpacker.md +0 -90
  109. data/docs/javascript/webpack-v1-notes.md +0 -23
  110. data/docs/javascript/webpack.md +0 -22
  111. data/docs/misc/articles.md +0 -20
  112. data/docs/misc/code_of_conduct.md +0 -13
  113. data/docs/misc/doctrine.md +0 -77
  114. data/docs/misc/style.md +0 -33
  115. data/docs/misc/tips.md +0 -10
  116. data/docs/outdated/deferred-rendering.md +0 -39
  117. data/docs/outdated/rails-assets-relative-paths.md +0 -195
  118. data/docs/outdated/rails-assets.md +0 -77
  119. data/docs/outdated/rails3.md +0 -9
  120. data/docs/rails/convert-rails-5-api-only-app.md +0 -19
  121. data/docs/rails/rails-engine-integration.md +0 -32
  122. data/docs/rails/rails_view_rendering_from_inline_javascript.md +0 -36
  123. data/docs/rails/turbolinks.md +0 -124
  124. data/docs/react-on-rails-pro/react-on-rails-pro.md +0 -43
  125. data/docs/testimonials/hvmn.md +0 -25
  126. data/docs/testimonials/resortpass.md +0 -13
  127. data/docs/testimonials/testimonials.md +0 -28
  128. data/jest.config.js +0 -4
  129. data/package-scripts.yml +0 -49
  130. data/package.json +0 -96
  131. data/rakelib/docker.rake +0 -26
  132. data/rakelib/dummy_apps.rake +0 -30
  133. data/rakelib/example_type.rb +0 -96
  134. data/rakelib/examples.rake +0 -64
  135. data/rakelib/examples_config.yml +0 -14
  136. data/rakelib/lint.rake +0 -30
  137. data/rakelib/node_package.rake +0 -15
  138. data/rakelib/release.rake +0 -92
  139. data/rakelib/run_rspec.rake +0 -103
  140. data/rakelib/task_helpers.rb +0 -62
  141. data/script/bootstrap +0 -33
  142. data/script/release +0 -3
  143. data/script/setup +0 -23
  144. data/script/test +0 -38
  145. data/webpackConfigLoader.js +0 -71
  146. data/yarn.lock +0 -7010
@@ -1,77 +0,0 @@
1
- # Rails assets and the Extract Text Plugin
2
-
3
- *This doc needs updating for the use of rails/webpacker with React on Rails*
4
-
5
- The [Webpack file loader](https://github.com/webpack/file-loader) copies referenced files to
6
- the destination output directory, with an MD5 hash. The other term for this is a "digest".
7
-
8
- > By default the filename of the resulting file is the MD5 hash of the file's contents with
9
- the original extension of the required resource.
10
-
11
- The most common use cases for Webpack processed files are images used for backgrounds in
12
- CSS and fonts for CSS. However, this applies to any file that might be processed using the
13
- Webpack file loader.
14
-
15
- ## The Problem
16
- To understand the problem, it helps to read this article:
17
- [What is fingerprinting and why should I care](http://guides.rubyonrails.org/asset_pipeline.html#what-is-fingerprinting-and-why-should-i-care-questionmark)
18
- Basically, when Rails prepares assets for production deployments, it also adds a digest
19
- to the file names. E.g., `img1.jpg` becomes `img1-dbu097452jf2v2.jpg`.
20
-
21
- When compiling its native css Rails transforms all urls and links to digested
22
- versions, i.e. `background-image: image-url(img1.jpg)` becomes
23
- `background-image: url(img1-dbu097452jf2v2.jpg)`. However this doesn't happen for js and
24
- css files compiled by webpack on the client side, because they don't use
25
- `image-url` and `asset-url`. Without some fix, these assets would fail to load.
26
-
27
- When Webpack's client JavaScript uses images in render methods, e.g. `<img src='...' />` or
28
- in css, e.g. `background-image: url(...)` The code (such as the CSS) generated by the Webpack
29
- will have the Webpack digested name (MD5 hash). Since the Webpack generated CSS expects
30
- just one level of "digesting", this "double-digesting" from Rails will cause such these assets
31
- fail to load.
32
-
33
- _If you are interested in learning how to use assets in your React components, read this doc: [Webpack, the Asset Pipeline, and Using Assets w/ React](https://www.shakacode.com/react-on-rails/docs/outdated/rails-assets-relative-paths/)_
34
-
35
- ## The Solution: Symlink Original File Names to New File Names
36
- _Note, this solution was removed in v14. If you're intersted in this symlink solution, please create
37
- a github issue._
38
-
39
- ## Example from /spec/dummy
40
-
41
- ```
42
- cd spec/dummy
43
- RAILS_ENV=production bundle exec rake assets:precompile
44
- rails s -e production
45
- ```
46
-
47
- You will see this. This shows how the file names output by rails. Note the original names after
48
- being processed by Webpack are just MD5's.
49
-
50
- ```
51
- I, [2016-07-17T23:46:56.301981 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/server-bundle-42935dea382802a27e91b7df444a2813f74b4e6a0fce5606d863aaa10c0623d7.js
52
- I, [2016-07-17T23:46:56.305649 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/server-bundle-42935dea382802a27e91b7df444a2813f74b4e6a0fce5606d863aaa10c0623d7.js.gz
53
- I, [2016-07-17T23:46:56.370390 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/application_static-dfa728160c3cdebc633c2f6fb3823411530b307044f4dfe460790eef00b4e421.js
54
- I, [2016-07-17T23:46:56.370566 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/application_static-dfa728160c3cdebc633c2f6fb3823411530b307044f4dfe460790eef00b4e421.js.gz
55
- I, [2016-07-17T23:46:56.372895 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/application_static-17ed778d5061d4797556632b7bfbf405e067d9e7f140060a7f56a09788251f16.css
56
- I, [2016-07-17T23:46:56.373012 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/application_static-17ed778d5061d4797556632b7bfbf405e067d9e7f140060a7f56a09788251f16.css.gz
57
- I, [2016-07-17T23:46:56.374531 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/2ac2dd94f9b7e54292f6d051f1e4e756-ab14eebb171a9a5c9bfdeb2f88933d2dc4904ea8bb09444984e52b13d230e251.svg
58
- I, [2016-07-17T23:46:56.374818 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/2ac2dd94f9b7e54292f6d051f1e4e756-ab14eebb171a9a5c9bfdeb2f88933d2dc4904ea8bb09444984e52b13d230e251.svg.gz
59
- I, [2016-07-17T23:46:56.392207 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/5cf5db49df178f9357603f945752a1ef-033650e1d6193b70d59bb60e773f47b6d9aefdd56abc7ccdba3c7bed4e57ccad.png
60
- I, [2016-07-17T23:46:56.393208 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/8970f5e1e92aea933b502a2d73976b76-877bde3739dc7080c3fb00ee9012db6f21ed0dbbf11cd596dbb6e1a35bfb71f9.png
61
- I, [2016-07-17T23:46:56.395490 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/ecb4572a5e478b107dfcb60c16a7eefa-6d1ab3741d5a164dc2aab48bb74429aebe2e2e29606feca581081697624dc18c.ttf
62
- I, [2016-07-17T23:46:56.395846 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/ecb4572a5e478b107dfcb60c16a7eefa-6d1ab3741d5a164dc2aab48bb74429aebe2e2e29606feca581081697624dc18c.ttf.gz
63
- I, [2016-07-17T23:46:56.396979 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fbd0d00cc9b670f05c17893a40da08d0-5731789fd0d7847a582b52b55a83e7a0ad4684acd5a9b487557635a08c112d0e.svg
64
- I, [2016-07-17T23:46:56.397669 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fbd0d00cc9b670f05c17893a40da08d0-5731789fd0d7847a582b52b55a83e7a0ad4684acd5a9b487557635a08c112d0e.svg.gz
65
- I, [2016-07-17T23:46:56.399261 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fc2dcaaf2057331ff76c5d37e1aa7056-efba50c701b697fc8160603b9e876adcf47511f35af68701db285272c965a45f.svg
66
- I, [2016-07-17T23:46:56.399660 #77382] INFO -- : Writing /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fc2dcaaf2057331ff76c5d37e1aa7056-efba50c701b697fc8160603b9e876adcf47511f35af68701db285272c965a45f.svg.gz
67
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/2ac2dd94f9b7e54292f6d051f1e4e756-ab14eebb171a9a5c9bfdeb2f88933d2dc4904ea8bb09444984e52b13d230e251.svg to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/2ac2dd94f9b7e54292f6d051f1e4e756.svg
68
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/2ac2dd94f9b7e54292f6d051f1e4e756-ab14eebb171a9a5c9bfdeb2f88933d2dc4904ea8bb09444984e52b13d230e251.svg.gz to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/2ac2dd94f9b7e54292f6d051f1e4e756.svg.gz
69
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/5cf5db49df178f9357603f945752a1ef-033650e1d6193b70d59bb60e773f47b6d9aefdd56abc7ccdba3c7bed4e57ccad.png to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/5cf5db49df178f9357603f945752a1ef.png
70
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/8970f5e1e92aea933b502a2d73976b76-877bde3739dc7080c3fb00ee9012db6f21ed0dbbf11cd596dbb6e1a35bfb71f9.png to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/8970f5e1e92aea933b502a2d73976b76.png
71
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/ecb4572a5e478b107dfcb60c16a7eefa-6d1ab3741d5a164dc2aab48bb74429aebe2e2e29606feca581081697624dc18c.ttf to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/ecb4572a5e478b107dfcb60c16a7eefa.ttf
72
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/ecb4572a5e478b107dfcb60c16a7eefa-6d1ab3741d5a164dc2aab48bb74429aebe2e2e29606feca581081697624dc18c.ttf.gz to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/ecb4572a5e478b107dfcb60c16a7eefa.ttf.gz
73
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fbd0d00cc9b670f05c17893a40da08d0-5731789fd0d7847a582b52b55a83e7a0ad4684acd5a9b487557635a08c112d0e.svg to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fbd0d00cc9b670f05c17893a40da08d0.svg
74
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fbd0d00cc9b670f05c17893a40da08d0-5731789fd0d7847a582b52b55a83e7a0ad4684acd5a9b487557635a08c112d0e.svg.gz to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fbd0d00cc9b670f05c17893a40da08d0.svg.gz
75
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fc2dcaaf2057331ff76c5d37e1aa7056-efba50c701b697fc8160603b9e876adcf47511f35af68701db285272c965a45f.svg to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fc2dcaaf2057331ff76c5d37e1aa7056.svg
76
- React On Rails: Symlinking /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fc2dcaaf2057331ff76c5d37e1aa7056-efba50c701b697fc8160603b9e876adcf47511f35af68701db285272c965a45f.svg.gz to /Users/justin/shakacode/react_on_rails/spec/dummy/public/assets/fc2dcaaf2057331ff76c5d37e1aa7056.svg
77
- ```
@@ -1,9 +0,0 @@
1
- # Rails 3
2
-
3
- * Please let us know if you find any issues with Rails 3.
4
- * Rails 3 is confirmed to work up with versions up to 6.8.x.
5
- * We are not testing it for new releases. If you find an issue, you will have to submit a PR to get it fixed.
6
-
7
- ## Known Issues
8
-
9
- 1. If you do not skip bootstrap for the generator, you cannot generate a working app, as bootstrap-sass does not support Rails 3, or at least the version we're using.
@@ -1,19 +0,0 @@
1
- # Convert Rails 5 API only app to a Rails app
2
-
3
- 1. Go to the directory where you created your app
4
-
5
- ```bash
6
- $ rails new your-current-app-name
7
- ```
8
-
9
- Rails will start creating the app and will skip the files you have already created. If there is some conflict then it will stop and you need to resolve it manually. be careful at this step as it might replace you current code in conflicted files.
10
-
11
- 2. Resolve conflicts
12
-
13
- ```
14
- 1. Press "d" to see the difference
15
- 2. If it is only adding lines then press "y" to continue
16
- 3. If it is removeing some of your code then press "n" and add all additions manually
17
- ```
18
-
19
- 3. Run `bundle install` and follow [the instructions for installing into an existing Rails app](https://www.shakacode.com/react-on-rails/docs/guides/installation-into-an-existing-rails-app/)
@@ -1,32 +0,0 @@
1
- ## In your engine
2
-
3
- + At the top of `config/initializers/react_on_rails.rb`
4
- ```ruby
5
- ActiveSupport.on_load(:action_view) do
6
- include ReactOnRailsHelper
7
- end
8
- ```
9
- + In your `<engine_name>.gemspec`:
10
- ```ruby
11
- s.add_dependency 'react_on_rails', '~> 6'
12
- ```
13
- + In your `lib/<engine_name>.rb` (the entry point for your engine)
14
- ```ruby
15
- require "react_on_rails"
16
- ```
17
- ## In the project including your engine
18
-
19
- Place `gem 'react_on_rails', '~> 6'` before the gem pointing at your engine in your gemfile.
20
-
21
- Requiring `react_on_rails` and including the helper will get rid of any issues where react on rails or react_component is undefined.
22
-
23
- As far as solving the assets issue, `lib/tasks/assets.rake` in `react_on_rails` would somehow have to know that `react_on_rails` was included in an engine, and decide the path accordingly. This might be impossible, especially in the case of multiple engines using `react_on_rails` in a single application.
24
-
25
- Another solution would be to detach this rake task from the `rails assets:precompile` task. This can be done by adding `REACT_ON_RAILS_PRECOMPILE=false` to your environment. If you do so, then react assets will have to be bundled separately from `rails assets:precompile`.
26
-
27
- # Github Issues
28
-
29
- * [Integration with an engine #342](https://github.com/shakacode/react_on_rails/issues/342)
30
- * [Feature: target destination option for the install generator #459](https://github.com/shakacode/react_on_rails/issues/459)
31
- * [Integration with Rails 5 Engines #562](https://github.com/shakacode/react_on_rails/issues/562)
32
- * [Run inside a Rails engine? #257](https://github.com/shakacode/react_on_rails/issues/257)
@@ -1,36 +0,0 @@
1
- # Using ReactOnRails in JavaScript
2
- You can easily render React components in your JavaScript with `render` method that returns a [reference to the component](https://facebook.github.io/react/docs/more-about-refs.html) (virtual DOM element).
3
-
4
- ```js
5
- /**
6
- * ReactOnRails.render("HelloWorldApp", {name: "Stranger"}, 'app');
7
- *
8
- * Does this:
9
- * ReactDOM.render(React.createElement(HelloWorldApp, {name: "Stranger"}),
10
- * document.getElementById('app'))
11
- *
12
- * @param name Name of your registered component
13
- * @param props Props to pass to your component
14
- * @param domNodeId
15
- * @param hydrate [optional] Pass truthy to update server rendered html. Default is falsy
16
- * @returns {virtualDomElement} Reference to your component's backing instance
17
- */
18
- ReactOnRails.render(componentName, props, domNodeId)
19
- ```
20
-
21
- ## Why do we need this?
22
- Imagine that we have some event with jQuery, it allows us to set component state manually.
23
-
24
- ```html
25
- <input id="input" type="range" min="0" max="100" />
26
- <div id="root"></div>
27
-
28
- <script>
29
- var input = $("#input");
30
- var component = ReactOnRails.render("componentName", { value: input.val() }, "root");
31
-
32
- input.on("change", function(e) {
33
- component.setState({ value: input.val() });
34
- });
35
- </script>
36
- ```
@@ -1,124 +0,0 @@
1
- # Turbolinks and Turbo
2
-
3
- ## Updated to support Turbo
4
- * See [PR 1374](https://github.com/shakacode/react_on_rails/pull/1374).
5
- * Ability to use with Turbo (@hotwired/turbo), as Turbolinks gets obsolete.
6
-
7
- To configure turbo the following option can be set:
8
- `ReactOnRails.setOptions({ turbo: true })`
9
-
10
- Turbo is not auto-detected like older Turbolinks.
11
-
12
- *Below docs maybe outdated*
13
-
14
- * See [Turbolinks on Github](https://github.com/rails/turbolinks)
15
- * React on Rails currently supports 2.5.x of Turbolinks and 5.0.0 of Turbolinks 5.
16
- * You may include Turbolinks either via yarn (recommended) or via the gem.
17
-
18
- ## Why Turbolinks?
19
- As you switch between Rails HTML controller requests, you will only load the HTML and you will
20
- not reload JavaScript and stylesheets. This definitely can make an app perform better, even if
21
- the JavaScript and stylesheets are cached by the browser, as they will still require parsing.
22
-
23
- ## Requirements for Using Turbolinks
24
- 1. You are **not using [react-router](https://github.com/ReactTraining/react-router)** or you are prepared to deal with some potential issues with where react-router and Turbolinks overlaps.
25
- 2. You are **using one JS and one CSS file** throughout your app. Otherwise, you will have to figure out how best to handle multiple JS and CSS files throughout the app given Turbolinks.
26
-
27
- ## Why Not Turbolinks
28
- 1. [react-router](https://github.com/ReactTraining/react-router) handles the back and forward buttons, as does TurboLinks. You *might* be able to make this work. *Please share your findings.*
29
- 1. You want to do code splitting to minimize the JavaScript loaded.
30
-
31
- ## More Information
32
- * CSRF tokens need thorough checking with Turbolinks5. Turbolinks5 changes the head element by JavaScript (not only body) on page changes with the correct csrf meta tag, but if the JS code parsed this from head when several windows were opened, then our specs were not all passing. I didn't look details however, may be it is app code related, not library code. Anyway it may need additional check because there is CSRF helper in ReactOnRails and it need to work with Turbolinks5.
33
- * Turbolinks5 send requests without the `Accept: */*` in the header, only exactly like `Accept: text/html` which makes Rails behave a bit specifically compared to normal and mime-parsing, which is skipped by when Rails see */*. For some more details on Rails and */* can read [Mime Type Resolution in Rails](http://blog.bigbinary.com/2010/11/23/mime-type-resolution-in-rails.html)
34
- * If you're using multiple Webpack bundles, be sure to ensure that there are no name conflicts between JS objects or redux store paths.
35
-
36
- ### Install Checklist
37
- 1. Include turbolinks via yarn as shown in the [react-webpack-rails-tutorial](https://github.com/shakacode/react-webpack-rails-tutorial/blob/8a6c8aa2e3b7ae5b08b0a9744fb3a63a2fe0f002/client/webpack.client.base.config.js#L22) or include the gem "turbolinks".
38
- 1. Included the proper "track" tags when you include the javascript and stylesheet:
39
- ```erb
40
- <%= stylesheet_link_tag 'application', media: 'all', 'data-turbolinks-track' => 'reload' %>
41
- <%= javascript_include_tag 'application', 'data-turbolinks-track' => 'reload' %>
42
- ```
43
- NOTE: for Turbolinks 2.x, use 'data-turbolinks-track' => true
44
- 1. Add turbolinks to your `application.js` file:
45
- ```javascript
46
- //= require turbolinks
47
- ```
48
-
49
- ## Turbolinks 5
50
- Turbolinks 5 is now being supported. React on Rails will automatically detect which version of Turbolinks you are using and use the correct event handlers.
51
-
52
- For more information on Turbolinks 5: [https://github.com/turbolinks/turbolinks](https://github.com/turbolinks/turbolinks)
53
-
54
- ## Turbolinks from NPM
55
-
56
- See the [instructions on installing from NPM](https://github.com/turbolinks/turbolinks#installation-using-npm).
57
-
58
- ```js
59
- import Turbolinks from "turbolinks";
60
- Turbolinks.start();
61
- ```
62
-
63
- ### async script loading
64
- Generally async script loading can be done like:
65
- ```erb
66
- <%= javascript_include_tag 'application', async: Rails.env.production? %>
67
- ```
68
- If you use ```document.addEventListener("turbolinks:load", function() {...});``` somewhere in your code, you will notice, that Turbolinks 5 does not fire ```turbolinks:load``` on initial page load. A quick workaround is to use ```defer``` instead of ```async```:
69
- ```erb
70
- <%= javascript_include_tag 'application', defer: Rails.env.production? %>
71
- ```
72
- More information on this issue can be found here: https://github.com/turbolinks/turbolinks/issues/28
73
-
74
- When loading your scripts asynchronously you may experience, that your Components are not registered correctly. Call ```ReactOnRails.reactOnRailsPageLoaded()``` to re-initialize like so:
75
- ```
76
- document.addEventListener("turbolinks:load", function() {
77
- ReactOnRails.reactOnRailsPageLoaded();
78
- });
79
- ```
80
-
81
- ## Troubleshooting
82
- To turn on tracing of Turbolinks events, put this in your registration file, where you register your components.
83
-
84
- ```js
85
- ReactOnRails.setOptions({
86
- traceTurbolinks: true,
87
- turbo: true,
88
- });
89
- ```
90
-
91
- Rather than setting the value to true, you could set it to TRACE_TURBOLINKS, and then you could place this in your `webpack.client.base.config.js`:
92
-
93
- Define this const at the top of the file:
94
- ```js
95
- const devBuild = process.env.NODE_ENV !== 'production';
96
- ```
97
-
98
- Add this DefinePlugin option:
99
- ```js
100
- plugins: [
101
- new webpack.DefinePlugin({
102
- TRACE_TURBOLINKS: devBuild,
103
- }),
104
- ```
105
-
106
- At Webpack compile time, the value of devBuild is inserted into your file.
107
-
108
- Once you do that, you'll see messages prefixed with **TURBO:** like this in the browser console:
109
-
110
- Turbolinks Classic:
111
- ```
112
- TURBO: WITH TURBOLINKS: document page:before-unload and page:change handlers installed. (program)
113
- TURBO: reactOnRailsPageLoaded
114
- ```
115
-
116
- Turbolinks 5:
117
- ```
118
- TURBO: WITH TURBOLINKS 5: document turbolinks:before-render and turbolinks:render handlers installed. (program)
119
- TURBO: reactOnRailsPageLoaded
120
- ```
121
-
122
- We've noticed that Turbolinks doesn't work if you use the ruby gem version of jQuery and jQuery ujs. Therefore we recommend using the node packages instead. See the [tutorial app](https://github.com/shakacode/react-webpack-rails-tutorial) for how to accomplish this.
123
-
124
- ![2016-02-02_10-38-07](https://cloud.githubusercontent.com/assets/1118459/12760060/6546e254-c999-11e5-828b-a8aaa473e5bd.png)
@@ -1,43 +0,0 @@
1
- ## React on Rails Pro
2
-
3
- Support React on Rails development [by becoming a Github sponsor](https://github.com/sponsors/shakacode) and get these benefits:
4
-
5
- 1. 1-hour per month of support via Slack, PR reviews, and Zoom for React on Rails,
6
- React-Rails, rails/webpacker, ReScript (ReasonML), TypeScript, Rust, etc.
7
- 2. React on Rails Pro Software that extends React on Rails with Node server rendering,
8
- fragment caching, code-splitting, and other performance enhancements for React on Rails.
9
-
10
- See the [React on Rails Pro Support Plan](https://www.shakacode.com/react-on-rails-pro/).
11
-
12
- ShakaCode can also help you with your custom software development needs. We specialize in
13
- marketplace and e-commerce applications that utilize both Rails and React.
14
- Because we own [HiChee.com](https://hichee.com), we can leverage that code for your app!
15
-
16
- Please email Justin Gordon [justin@shakacode.com](mailto:justin@shakacode.com), the
17
- maintainer of React on Rails, for more information.
18
-
19
- ### Pro: Fragment Caching
20
-
21
- Fragment caching is a [React on Rails Pro](https://www.shakacode.com/react-on-rails-pro/) feature. Fragment caching is a **HUGE** performance booster for your apps. Use the `cached_react_component` and `cached_react_component_hash`. The API is the same as `react_component` and `react_component_hash`, but for 2 differences:
22
-
23
- 1. The `cache_key` takes the same parameters as any Rails `cache` view helper.
24
- 1. The **props** are passed via a block so that evaluation of the props is not done unless the cache is broken. Suppose you put your props calculation into some method called `some_slow_method_that_returns_props`:
25
-
26
- ```ruby
27
- <%= cached_react_component("App", cache_key: [@user, @post], prerender: true) do
28
- some_slow_method_that_returns_props
29
- end %>
30
- ```
31
-
32
- Such fragment caching saves CPU work for your web server and greatly reduces the request time. It completely skips the evaluation costs of:
33
-
34
- 1. Database calls to compute the props.
35
- 2. Serialization the props values hash into a JSON string for evaluating JavaScript to server render.
36
- 3. Costs associated with evaluating JavaScript from your Ruby code.
37
- 4. Creating the HTML string containing the props and the server-rendered JavaScript code.
38
-
39
- Note, even without server rendering (without step 3 above), fragment caching is still effective.
40
-
41
- ### Pro: Integration with Node.js for Server Rendering
42
-
43
- Default server rendering is done by ExecJS. If you want to use a Node.js server for better performing server rendering, [email justin@shakacode.com](mailto:justin@shakacode.com). ShakaCode has built a premium Node rendering server that is part of [React on Rails Pro](https://www.shakacode.com/react-on-rails-pro).
@@ -1,25 +0,0 @@
1
- # HVMN Testimonial, Written by Paul Benigeri, October 12, 2018
2
-
3
- For some years, we used React on Rails for server-side rendering at [HVMN](https://hvmn.com). Our entire backend was already built in Rails, and we love React. As a content & e-commerce site, server-side rendering is critical, for UX performance and SEO crawler indexing.
4
-
5
- During the 12 months leading up to our React on Rails Pro transition, our traffic grew 10x. Our team of 2 engineers was focused on shipping features, and we started to face performance issues. We had some fragment caching of our React server rending, but it didn’t work that well.
6
-
7
- I discussed our growing pains with Justin, and as it turned out, ShakaCode just came out with React on Rails Pro and set it up on [egghead.io](https://egghead.io). The performance improvements were impressive, and Justin’s team was an ideal partner to help with the integration.
8
-
9
- We decided to give it a shot. Over three weeks, the ShakaCode team helped us migrate to React on Rails Pro, set up Webpack v4, migrated our entire asset pipeline to Webpack v4.
10
-
11
- Results were great. Our blog and product pages are 80-90% faster after that effort. The improved fragment caching was quick to set up and made a huge dent in our average server response times. We also observed an additional drop in response times when ShakaCode shipped the standalone Node server-side React renderer.
12
-
13
- Working with ShakaCode was a pleasure. Justin is one of the smartest Rails architects I know, and his team was responsive and productive.
14
-
15
- The price we paid for the consultation + the React on Rails pro license has already been made back a couple of times from hosting fees alone. The entire process was super hands off, and our core team was able to focus on shipping new feature during that sprint.
16
-
17
- If you have any questions, please reach out.
18
-
19
- Paul Benigeri, Head of E-Commerce
20
-
21
- [paul@hvmn.com](mailto:paul@hvmn.com), [LinkedIn](https://www.linkedin.com/in/benigeri/)
22
-
23
- Related Article: [HVMN’s 90% Reduction in Server Response Time from React on Rails Pro](https://blog.shakacode.com/hvmns-90-reduction-in-server-response-time-from-react-on-rails-pro-eb08226687db)
24
-
25
- [![image](https://user-images.githubusercontent.com/1118459/46911126-577abd00-ceee-11e8-86c6-6703ff80fc2f.png)](https://www.linkedin.com/in/benigeri/)
@@ -1,13 +0,0 @@
1
- # ResortPass Testimonial, by Leora Juster, December 10, 2018
2
-
3
- Many can write code that "works." Even fewer can write sophisticated code that both works and reflects a deep understanding of the technologies and paradigms involved. Only a select few can do the aforementioned while assisting in managing the expectations and time constraints of less technically informed members of software product teams to make the best design decisions possible. Justin and his team were instrumental in assisting us in setting design foundations and standards for our transition to a react on rails application. Just three months of work with the team at Shaka code and we have a main page of our application server-side rendering at exponentially improved speeds. The code and CSS files are well-organized and contain repeatable patterns easy to understand, allowing my team to build on what has already been accomplished. I learned a great deal from my interactions with Justin and his team, as they are just as great teachers as they are developers, and feel like I get to continually learn from them as I build on top of their code. Their different support and pro plan options make it easy to build a continuous professional relationship despite fluctuations in my team's funding, and their team is always extremely personable, punctual, and professional.
4
-
5
- Leora Juster, Full-Stack Lead Software Developer
6
-
7
- [LinkedIn](https://www.linkedin.com/in/leora-juster-38933050)
8
-
9
- ![image](https://user-images.githubusercontent.com/1118459/50050877-30399b00-00ab-11e9-9e52-2977de45ccae.png)
10
-
11
- [ResortPass](https://resortpass.com/)
12
-
13
- [![2018-12-15_20-48-35](https://user-images.githubusercontent.com/1118459/50050866-03858380-00ab-11e9-8588-461112f8045b.png)](https://resortpass.com/)
@@ -1,28 +0,0 @@
1
- # Testimonials
2
- # [HVMN Testimonial, Written by Paul Benigeri, October 12, 2018](https://www.shakacode.com/react-on-rails/docs/testimonials/hvmn/)
3
-
4
- > The price we paid for the consultation + the React on Rails pro license has already been made back a couple of times from hosting fees alone. The entire process was super hands off, and our core team was able to focus on shipping new feature during that sprint.
5
-
6
- Full writeup [here](https://www.shakacode.com/react-on-rails/docs/testimonials/hvmn/).
7
-
8
- ---
9
-
10
- # [Leora from ResortPass](https://www.shakacode.com/react-on-rails/docs/testimonials/resortpass/), December 10, 2018
11
-
12
- Justin and his team were instrumental in assisting us in setting design foundations and standards for our transition to a react on rails application. Just three months of work with the team at Shaka code and we have a main page of our application server-side rendering at exponentially improved speeds.
13
-
14
- Full writeup [here](https://www.shakacode.com/react-on-rails/docs/testimonials/resortpass/).
15
-
16
- ---
17
-
18
- From Joel Hooks, Co-Founder, Chief Nerd at [egghead.io](https://egghead.io/), January 30, 2017:
19
-
20
- ![2017-01-30_11-33-59](https://cloud.githubusercontent.com/assets/1118459/22443635/b3549fb4-e6e3-11e6-8ea2-6f589dc93ed3.png)
21
-
22
- ---
23
-
24
- From Kyle Maune of Cooper Aerial, May 4, 2018
25
-
26
- ![image](https://user-images.githubusercontent.com/1118459/40891236-9b0b406e-671d-11e8-80ee-c026dbd1d5a2.png)
27
-
28
- For more testimonials, see [Live Projects](https://github.com/shakacode/react_on_rails/tree/master/PROJECTS.md) and [Kudos](https://github.com/shakacode/react_on_rails/tree/master/KUDOS.md).
data/jest.config.js DELETED
@@ -1,4 +0,0 @@
1
- module.exports = {
2
- preset: 'ts-jest/presets/js-with-ts',
3
- testEnvironment: 'jsdom',
4
- };
data/package-scripts.yml DELETED
@@ -1,49 +0,0 @@
1
- scripts:
2
- lint:
3
- description: Run all linters (eslint, tsc)
4
- script: concurrently --prefix "[{name}]" --names "ESLINT" -c "blue,yellow,magenta,orange" "nps eslint"
5
-
6
- eslint:
7
- default:
8
- description: Run eslint.
9
- script: eslint . --ext ".js,.jsx,.ts"
10
- fix:
11
- description: Run eslint and auto-fix.
12
- script: nps "eslint --fix"
13
- debug:
14
- description: Run eslint in debug mode.
15
- script: DEBUG=eslint:cli-engine nps eslint
16
-
17
- format:
18
- default:
19
- description: Format files using prettier.
20
- script: concurrently --prefix "[{name}]" --names "ts,js,json" -c "yellow,magenta,green" "nps format.js" "nps format.json"
21
- listDifferent:
22
- description: Check that all files were formatted using prettier.
23
- script: |
24
- concurrently \
25
- --prefix "[{name}]" \
26
- --names "ts,js,json" \
27
- -c "yellow,magenta" \
28
- "nps format.js.listDifferent" \
29
- "nps format.json.listDifferent"
30
- js:
31
- default:
32
- description: Run prettier-eslint on JS.
33
- #script: prettier "packages/**/*.@(js|jsx)" "spec/dummy/client/app/**/*.@(js|jsx)" "webpack.config.babel.js" "webpack/**/*.js" --write
34
- script: prettier "**/*.@(js|jsx)" --write
35
- listDifferent:
36
- description: Check if any JS files would change by running prettier-eslint.
37
- # script: prettier "**/*.@(js|jsx)" "webpack.config.babel.js" "webpack/**/*.js" --list-different
38
- script: prettier "**/*.@(js|jsx)" --list-different
39
- json:
40
- default:
41
- description: Run prettier on JSON files.
42
- script: rm -rf packages/vm-renderer/tests/tmp && prettier "**/*.json" --write
43
- listDifferent:
44
- description: Check if any JSON files would change by running prettier-eslint.
45
- script: prettier "**/*.json" --list-different
46
-
47
- renderer:
48
- description: Starts the node renderer.
49
- script: node renderer.js
data/package.json DELETED
@@ -1,96 +0,0 @@
1
- {
2
- "name": "react-on-rails",
3
- "version": "13.3.5",
4
- "description": "react-on-rails JavaScript for react_on_rails Ruby gem",
5
- "main": "node_package/lib/ReactOnRails.js",
6
- "directories": {
7
- "doc": "docs"
8
- },
9
- "devDependencies": {
10
- "@babel/cli": "^7.20.7",
11
- "@babel/core": "^7.20.12",
12
- "@babel/plugin-transform-runtime": "^7.19.6",
13
- "@babel/plugin-transform-typescript": "^7.20.13",
14
- "@babel/preset-env": "^7.20.2",
15
- "@babel/preset-react": "^7.18.6",
16
- "@babel/types": "^7.20.7",
17
- "@types/jest": "^28.1.3",
18
- "@types/react": "^16.14.35",
19
- "@types/react-dom": "^16.9.17",
20
- "@types/turbolinks": "^5.2.0",
21
- "@types/webpack-env": "^1.18.0",
22
- "@typescript-eslint/eslint-plugin": "^4.33.0",
23
- "@typescript-eslint/parser": "^4.33.0",
24
- "babelify": "^10.0.0",
25
- "blue-tape": "^1.0.0",
26
- "create-react-class": "^15.7.0",
27
- "eslint": "^7.32.0",
28
- "eslint-config-prettier": "^7.0.0",
29
- "eslint-config-shakacode": "^16.0.1",
30
- "eslint-plugin-import": "^2.27.5",
31
- "eslint-plugin-jsx-a11y": "^6.7.1",
32
- "eslint-plugin-prettier": "^3.4.1",
33
- "eslint-plugin-react": "^7.32.1",
34
- "jest": "^28.1.3",
35
- "jest-environment-jsdom": "^28.1.3",
36
- "jsdom": "^16.4.0",
37
- "nps": "^5.9.3",
38
- "prettier": "^2.8.3",
39
- "prettier-eslint-cli": "^5.0.0",
40
- "prop-types": "^15.8.1",
41
- "react": "^16.14.0",
42
- "react-dom": "^16.14.0",
43
- "react-transform-hmr": "^1.0.4",
44
- "redux": "^4.2.0",
45
- "ts-jest": "^28.0.8",
46
- "typescript": "^4.9.4"
47
- },
48
- "dependencies": {
49
- "@babel/runtime-corejs3": "^7.12.5",
50
- "concurrently": "^5.1.0"
51
- },
52
- "peerDependencies": {
53
- "js-yaml": ">= 3.0.0",
54
- "react": ">= 16",
55
- "react-dom": ">= 16"
56
- },
57
- "files": [
58
- "node_package/lib",
59
- "webpackConfigLoader.js"
60
- ],
61
- "scripts": {
62
- "test": "jest node_package/tests",
63
- "clean": "rm -rf node_package/lib",
64
- "start": "nps",
65
- "prepare": "yarn run build",
66
- "build": "yarn run clean && yarn run tsc --declaration",
67
- "build-watch": "yarn run clean && yarn run tsc --watch",
68
- "lint": "nps eslint",
69
- "check": "yarn run lint && yarn run test && yarn run type-check",
70
- "type-check": "yarn run tsc --noEmit --noErrorTruncation",
71
- "prerelease": "yarn run check && yarn run clean && yarn run build",
72
- "release:patch": "node_package/scripts/release patch",
73
- "release:minor": "node_package/scripts/release minor",
74
- "release:major": "node_package/scripts/release major",
75
- "dummy:install": "rake dummy_apps",
76
- "dummy:spec": "rake run_rspec:dummy"
77
- },
78
- "repository": {
79
- "type": "git",
80
- "url": "git+https://github.com/shakacode/react_on_rails.git"
81
- },
82
- "keywords": [
83
- "react",
84
- "webpack",
85
- "JavaScript",
86
- "Ruby",
87
- "on",
88
- "Rails"
89
- ],
90
- "author": "justin.gordon@gmail.com",
91
- "license": "MIT",
92
- "bugs": {
93
- "url": "https://github.com/shakacode/react_on_rails/issues"
94
- },
95
- "homepage": "https://github.com/shakacode/react_on_rails#readme"
96
- }
data/rakelib/docker.rake DELETED
@@ -1,26 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- namespace :docker do
4
- desc "Run Rubocop linter from docker"
5
- task :rubocop do
6
- sh "docker-compose run lint rake lint:rubocop"
7
- end
8
-
9
- desc "Run scss-lint linter from docker"
10
- task :scss do
11
- sh "docker-compose run lint rake lint:scss"
12
- end
13
-
14
- desc "Run eslint linter from docker"
15
- task :eslint do
16
- sh "docker-compose run lint rake lint:eslint"
17
- end
18
-
19
- desc "Run all linting from docker"
20
- task :lint do
21
- sh "docker-compose run lint rake lint"
22
- end
23
- end
24
-
25
- desc "Runs all linters from docker. Run `rake -D docker` to see all available lint options"
26
- task docker: ["docker:lint"]
@@ -1,30 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative "task_helpers"
4
-
5
- namespace :dummy_apps do
6
- include ReactOnRails::TaskHelpers
7
-
8
- task :yarn_install do
9
- yarn_install_cmd = "yarn install --mutex network"
10
- sh_in_dir(dummy_app_dir, yarn_install_cmd)
11
- sh_in_dir(dummy_app_dir, "yalc link react-on-rails")
12
- end
13
-
14
- task dummy_app: [:yarn_install] do
15
- dummy_app_dir = File.join(gem_root, "spec/dummy")
16
- bundle_install_in(dummy_app_dir)
17
- end
18
-
19
- task :generate_packs do
20
- dummy_app_dir = File.join(gem_root, "spec/dummy")
21
- sh_in_dir(dummy_app_dir, "bundle exec rake react_on_rails:generate_packs")
22
- end
23
-
24
- task dummy_apps: %i[dummy_app node_package generate_packs] do
25
- puts "Prepared all Dummy Apps"
26
- end
27
- end
28
-
29
- desc "Prepares all dummy apps by installing dependencies"
30
- task dummy_apps: ["dummy_apps:dummy_apps"]