rails-hyperstack 1.0.alpha1.2 → 1.0.alpha1.7

data/lib/generators/install/hyperstack_generator_base.rb

@@ -0,0 +1,102 @@
+require 'rails/generators'
+
+module Rails
+  module Generators
+    class Base < Thor::Group
+
+      protected
+
+      def warnings
+        @warnings ||= []
+      end
+
+      def clear_cache
+        run 'rm -rf tmp/cache' unless Dir.exists?(Rails.root.join('app', 'hyperstack'))
+      end
+
+      def insure_hyperstack_loader_installed
+        hyperstack_loader = %r{//=\s+require\s+hyperstack-loader\s+}
+        application_js = Rails.root.join(
+          'app', 'assets', 'javascripts', 'application.js'
+        )
+        if File.exist? application_js
+          unless File.foreach(application_js).any? { |l| l =~ hyperstack_loader }
+            require_tree = %r{//=\s+require_tree\s+}
+            if File.foreach(application_js).any? { |l| l =~ require_tree }
+              inject_into_file 'app/assets/javascripts/application.js', before: require_tree do
+                "//= require hyperstack-loader\n"
+              end
+            else
+              warnings <<
+                " ***********************************************************\n"\
+                " * Could not add `//= require hyperstack-loader` directive *\n"\
+                " * to the app/assets/application.js file.                  *\n"\
+                " * Normally this directive is added just before the        *\n"\
+                " * `//= require_tree .` directive at the end of the file,  *\n"\
+                " * but no require_tree directive was found.  You need to   *\n"\
+                " * manually add `//= require hyperstack-loader` to the     *\n"\
+                " * app/assets/application.js file.                         *\n"\
+                " ***********************************************************\n"
+            end
+          end
+        else
+          create_file application_js, "//= require hyperstack-loader\n"
+          warnings <<
+            " ***********************************************************\n"\
+            " * Could not find the  app/assets/application.js file.     *\n"\
+            " * We created one for you, and added the                   *\n"\
+            " * `<%= javascript_include_tag 'application' %>` to your   *\n"\
+            " * `html.erb` files immediately after any                  *\n"\
+            " * `<%= javascript_pack 'application' %>` tags we found.   *\n"\
+            " ***********************************************************\n"
+          application_pack_tag =
+            /\s*\<\%\=\s+javascript_pack_tag\s+(\'|\")application(\'|\").*\%\>.*$/
+          Dir.glob(Rails.root.join('app', 'views', '**', '*.erb')) do |file|
+            if File.foreach(file).any? { |l| l =~ application_pack_tag }
+              inject_into_file file, after: application_pack_tag do
+                "\n    <%= javascript_include_tag 'application' %>"
+              end
+            end
+          end
+        end
+      end
+
+      def insure_base_component_class_exists
+        @component_base_class = options['base-class']
+        file_name = Rails.root.join(
+          'app', 'hyperstack', 'components', "#{@component_base_class.underscore}.rb"
+        )
+        template 'hyper_component_template.rb', file_name unless File.exists? file_name
+      end
+
+      def add_to_manifest(manifest, &block)
+        if File.exists? "app/javascript/packs/#{manifest}"
+          append_file "app/javascript/packs/#{manifest}", &block
+        else
+          create_file "app/javascript/packs/#{manifest}", &block
+        end
+      end
+
+      def add_route
+        return unless options['add-route']
+        if self.components.count > 1
+          warnings <<
+               " ***********************************************************\n"\
+               " * The add-route option ignored because more than one      *\n"\
+               " * component is being generated.                           *\n"\
+               " ***********************************************************\n"
+          return
+        end
+        action_name = (@modules+[@file_name.underscore]).join('__')
+        path = options['add-route'] == 'add-route' ? '/(*others)' : options['add-route']
+        route "get '#{path}', to: 'hyperstack##{action_name}'"
+      end
+
+
+      def yarn(package, version = nil)
+        return if system("yarn add #{package}#{'@' + version if version}")
+        raise Thor::Error.new("yarn failed to install #{package} with version #{version}")
+      end
+    end
+  end
+end

data/lib/hyperstack/server_side_auto_require.rb

@@ -0,0 +1,39 @@
+Rails.configuration.autoloader = :classic
+
+module ActiveSupport
+  module Dependencies
+    HYPERSTACK_DIR = "hyperstack"
+    class << self
+      alias original_require_or_load require_or_load
+
+      # before requiring_or_loading a file, first check if
+      # we have the same file in the server side directory
+      # and add that as a dependency
+
+      def require_or_load(file_name, const_path = nil)
+        add_server_side_dependency(file_name)
+        original_require_or_load(file_name, const_path)
+      end
+
+      # search the filename path from the end towards the beginning
+      # for the HYPERSTACK_DIR directory.  If found, remove it from
+      # the filename, and if a ruby file exists at that location then
+      # add it as a dependency
+
+      def add_server_side_dependency(file_name)
+        path = File.expand_path(file_name.chomp(".rb"))
+                   .split(File::SEPARATOR).reverse
+        hs_index = path.find_index(HYPERSTACK_DIR)
+
+        return unless hs_index # no hyperstack directory here
+
+        new_path = (path[0..hs_index - 1] + path[hs_index + 1..-1]).reverse
+        load_path = new_path.join(File::SEPARATOR)
+
+        return unless File.exist? "#{load_path}.rb"
+
+        require_dependency load_path
+      end
+    end
+  end
+end

data/lib/hyperstack/version.rb

@@ -1,3 +1,3 @@
 module Hyperstack
-  ROUTERVERSION = VERSION = '1.0.alpha1.2'
+  ROUTERVERSION = VERSION = '1.0.alpha1.7'
 end

data/lib/rails-hyperstack.rb

@@ -1,6 +1,5 @@
 require 'hyperstack-config'
 require 'rails/generators'
-require 'hyper-state'
 
 # remove these once lap29 is released ...
 Hyperstack.js_import 'react/react-source-browser', client_only: true, defines: ['ReactDOM', 'React']
@@ -14,15 +13,24 @@ Hyperstack.import 'hyper-model'
 Hyperstack.import 'hyper-state'
 
 require 'generators/hyperstack/install_generator'
+require 'generators/hyper/generator_base'
 require 'generators/hyper/component_generator'
 require 'generators/hyper/router_generator'
 begin
   require 'opal-rails'
   require 'hyper-model'
   require 'hyper-router'
+  require 'mini_racer'
 rescue LoadError
 end
 require 'react-rails'
 require 'opal-browser'
-require 'mini_racer'
 require 'hyperstack/version'
+
+class RailsHyperstack < Rails::Railtie
+  rake_tasks do
+    Dir[File.join(File.dirname(__FILE__),'tasks/hyperstack/*.rake')].each { |f| puts "loading #{f}"; load f }
+  end
+end
+
+Hyperstack.define_setting :component_base_class, 'HyperComponent'

data/lib/tasks/hyperstack/install.rake

@@ -0,0 +1,32 @@
+# install_template_path = File.expand_path("../../install/template.rb", __dir__).freeze
+bin_path = ENV["BUNDLE_BIN"] || "./bin"
+require 'optparse'
+
+namespace :hyperstack do
+  desc "Install Hyperstack in this application"
+  task :install do
+    exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install"
+  end
+  namespace :install do
+    task :default do
+    end
+    task "hotloader" do
+      exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install --hotloader-only"
+    end
+    task "webpack" do
+      exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install --webpack-only"
+    end
+    task "hyper-model" do
+      exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install --hyper-model-only"
+    end
+    task "skip-hotloader" do
+      exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install --skip-hotloader"
+    end
+    task "skip-webpack" do
+      exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install --skip-webpack"
+    end
+    task "skip-hyper-model" do
+      exec "#{RbConfig.ruby} #{bin_path}/rails g hyperstack:install --skip-hyper-model"
+    end
+  end
+end

data/rails-hyperstack.gemspec

@@ -18,48 +18,74 @@ Gem::Specification.new do |spec|
   # }
   spec.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(tasks)/}) }
   spec.require_paths = ['lib']
+  spec.post_install_message = %q{
+*******************************************************************************
+
+Welcome to Hyperstack!
+
+For a quick start simply add a component using one of the generators:
+
+  >> bundle exec rails generate hyper:component CompName --add-route="/test/(*others)"
+     # Add a new component named CompName and route to it with /test/
+
+  >> bundle exec rails generate hyper:router CompName --add-route="/test/(*others)"
+     # Add a top level router named CompName and route to it
+
+The generators will insure you have the minimal additions to your system for the
+new component to run.  And note: --add-route is optional.
+
+For a complete install run the hyperstack install task:
+
+  >> bundle exec rails hyperstack:install
+
+This will add everything you need including the hotloader, webpack integration,
+hyper-model (active record model client synchronization) and a top level
+component to get you started.
+
+You can control how much of the stack gets installed as well:
+
+  >> bundle exec rails hyperstack:install:webpack          # just add webpack
+  >> bundle exec rails hyperstack:install:skip-webpack     # all but webpack
+  >> bundle exec rails hyperstack:install:hyper-model      # just add hyper-model
+  >> bundle exec rails hyperstack:install:skip-hyper-model # all but hyper-model
+  >> bundle exec rails hyperstack:install:hotloader        # just add the hotloader
+  >> bundle exec rails hyperstack:install:skip-hotloader   # skip the hotloader
+
+*******************************************************************************
+}
 
   spec.add_dependency 'hyper-model', Hyperstack::VERSION
   spec.add_dependency 'hyper-router', Hyperstack::ROUTERVERSION
   spec.add_dependency 'hyperstack-config', Hyperstack::VERSION
-  spec.add_dependency 'opal-rails', '~> 0.9.4'
+  spec.add_dependency 'opal-rails' #, '~> 2.0'
 
   spec.add_dependency 'opal-browser', '~> 0.2.0'
   spec.add_dependency 'react-rails', '>= 2.4.0', '< 2.5.0'
-  spec.add_dependency 'mini_racer', '~> 0.1.15'
-  # https://github.com/discourse/mini_racer/issues/92
-  spec.add_dependency 'libv8', '~> 6.3.0'
-  spec.add_dependency 'rails', '>= 4.0.0'
-
+  # spec.add_dependency 'mini_racer', '~> 0.2.6'
+  # spec.add_dependency 'libv8', '~> 7.3.492.27.1'
+  spec.add_dependency 'rails', ENV['RAILS_VERSION'] || '>= 5.0.0', '< 7.0'
 
-  # spec.add_development_dependency 'sqlite3'
-  # #spec.add_development_dependency 'chromedriver-helper'
-  # spec.add_development_dependency 'geminabox', '>= 0.13.11'
-
-
-  spec.add_development_dependency 'bundler', '~> 1.16.0'
+  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'chromedriver-helper'
   spec.add_development_dependency 'hyper-spec', Hyperstack::VERSION
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'puma'
   spec.add_development_dependency 'bootsnap'
-  #spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rubocop', '~> 0.51.0'
-  spec.add_development_dependency 'sqlite3'
-  spec.add_development_dependency 'sass-rails', '~> 5.0'
+  spec.add_development_dependency 'rspec-rails'
+  spec.add_development_dependency 'rubocop' #, '~> 0.51.0'
+  spec.add_development_dependency 'sqlite3', '~> 1.4' # was 1.3.6 -- see https://github.com/rails/rails/issues/35153
+  spec.add_development_dependency 'sass-rails', '>= 5.0'
   # Use Uglifier as compressor for JavaScript assets
   spec.add_development_dependency 'uglifier', '>= 1.3.0'
   # See https://github.com/rails/execjs#readme for more supported runtimes
   # gem 'mini_racer', platforms: :ruby
 
   # Use CoffeeScript for .coffee assets and views
-  spec.add_development_dependency 'coffee-rails', '~> 4.2'
+  #spec.add_development_dependency 'coffee-rails', '~> 4.2'
   # Turbolinks makes navigating your web application faster. Read more: https://github.com/turbolinks/turbolinks
   spec.add_development_dependency 'turbolinks', '~> 5'
   # Build JSON APIs with ease. Read more: https://github.com/rails/jbuilder
   spec.add_development_dependency 'jbuilder', '~> 2.5'
   spec.add_development_dependency 'foreman'
   spec.add_development_dependency 'database_cleaner'
-
 end

data/spec/gems.rb

@@ -0,0 +1,10 @@
+gem 'rails-hyperstack',  path: '../..'
+gem 'hyperstack-config', path: '../../../hyperstack-config'
+gem 'hyper-state',       path: '../../../hyper-state'
+gem 'hyper-component',   path: '../../../hyper-component'
+gem 'hyper-operation',   path: '../../../hyper-operation'
+gem 'hyper-model',       path: '../../../hyper-model'
+gem 'hyper-router',      path: '../../../hyper-router'
+gem 'hyper-spec',        path: '../../../hyper-spec'
+
+gem 'pry'

data/spec/rails_hyperstack_spec.rb

@@ -1,24 +1,30 @@
-require 'spec_helper'
+require "spec_helper"
 
-describe 'rails-hyperstack' do
-  it 'builds a working app', js: true do
-    visit '/'
-    expect(page).to have_content('App')
+describe "rails-hyperstack" do
+  it "builds a working app", js: true do
+    visit "/"
+    expect(page).to have_content("App")
   end
-  it 'installs hyper-model and friends', js: true do
-    visit '/'
-    expect_promise do
+
+  it "installs hyper-model and friends", js: true do
+    visit "/"
+    expect do
       Hyperstack::Model.load { Sample.count }
-    end.to eq(0)
-    evaluate_ruby do
-      Sample.create(name: 'sample1', description: 'the first sample')
+    end.on_client_to eq(0)
+    on_client do
+      Sample.create(name: "sample1", description: "the first sample")
     end
     wait_for_ajax
     expect(Sample.count).to eq(1)
-    expect(Sample.first.name).to eq('sample1')
-    expect(Sample.first.description).to eq('the first sample')
-    expect_evaluate_ruby do
-      Sample.count
-    end.to eq(1)
+    expect(Sample.first.name).to eq("sample1")
+    expect(Sample.first.description).to eq("the first sample")
+    expect { Sample.count }.on_client_to eq(1)
+  end
+
+  it "implements server_side_auto_require", js: true do
+    expect(Sample.super_secret_server_side_method).to be true
+    expect do
+      Sample.respond_to? :super_secret_server_side_method
+    end.on_client_to be_falsy
   end
 end

data/spec/server_side_sample.rb

@@ -0,0 +1,5 @@
+class Sample < ApplicationRecord
+  def self.super_secret_server_side_method
+    true
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-hyperstack
 version: !ruby/object:Gem::Version
-  version: 1.0.alpha1.2
+  version: 1.0.alpha1.7
 platform: ruby
 authors:
 - Loic Boutet
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-16 00:00:00.000000000 Z
+date: 2021-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hyper-model
@@ -19,56 +19,56 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
 - !ruby/object:Gem::Dependency
   name: hyper-router
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
 - !ruby/object:Gem::Dependency
   name: hyperstack-config
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
 - !ruby/object:Gem::Dependency
   name: opal-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.4
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.4
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: opal-browser
   requirement: !ruby/object:Gem::Requirement
@@ -103,62 +103,40 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.5.0
-- !ruby/object:Gem::Dependency
-  name: mini_racer
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.15
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.15
-- !ruby/object:Gem::Dependency
-  name: libv8
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 6.3.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 6.3.0
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 5.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 5.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.16.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.16.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: chromedriver-helper
   requirement: !ruby/object:Gem::Requirement
@@ -179,14 +157,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.alpha1.2
+        version: 1.0.alpha1.7
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -230,7 +208,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -247,42 +225,42 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.51.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.51.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: sass-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '5.0'
 - !ruby/object:Gem::Dependency
@@ -299,20 +277,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.0
-- !ruby/object:Gem::Dependency
-  name: coffee-rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: turbolinks
   requirement: !ruby/object:Gem::Requirement
@@ -379,28 +343,70 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".ruby-version"
 - ".travis.yml"
 - Gemfile
-- Gemfile.lock
 - Rakefile
 - lib/generators/hyper/component_generator.rb
+- lib/generators/hyper/generator_base.rb
 - lib/generators/hyper/router_generator.rb
 - lib/generators/hyper/templates/component_template.rb
+- lib/generators/hyper/templates/hyper_component_template.rb
 - lib/generators/hyper/templates/router_template.rb
 - lib/generators/hyperstack/install_bootstrap_generator.rb
 - lib/generators/hyperstack/install_generator.rb
 - lib/generators/hyperstack/install_generator_base.rb
 - lib/generators/hyperstack/install_mui_generator.rb
+- lib/generators/install/hyperstack_generator.rb
+- lib/generators/install/hyperstack_generator_base.rb
+- lib/hyperstack/server_side_auto_require.rb
 - lib/hyperstack/version.rb
 - lib/rails-hyperstack.rb
+- lib/tasks/hyperstack/install.rake
 - rails-hyperstack.gemspec
+- spec/gems.rb
 - spec/rails_hyperstack_spec.rb
+- spec/server_side_sample.rb
 - spec/spec_helper.rb
 homepage: http://hyperstack.org
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message: |2
+
+  *******************************************************************************
+
+  Welcome to Hyperstack!
+
+  For a quick start simply add a component using one of the generators:
+
+    >> bundle exec rails generate hyper:component CompName --add-route="/test/(*others)"
+       # Add a new component named CompName and route to it with /test/
+
+    >> bundle exec rails generate hyper:router CompName --add-route="/test/(*others)"
+       # Add a top level router named CompName and route to it
+
+  The generators will insure you have the minimal additions to your system for the
+  new component to run.  And note: --add-route is optional.
+
+  For a complete install run the hyperstack install task:
+
+    >> bundle exec rails hyperstack:install
+
+  This will add everything you need including the hotloader, webpack integration,
+  hyper-model (active record model client synchronization) and a top level
+  component to get you started.
+
+  You can control how much of the stack gets installed as well:
+
+    >> bundle exec rails hyperstack:install:webpack          # just add webpack
+    >> bundle exec rails hyperstack:install:skip-webpack     # all but webpack
+    >> bundle exec rails hyperstack:install:hyper-model      # just add hyper-model
+    >> bundle exec rails hyperstack:install:skip-hyper-model # all but hyper-model
+    >> bundle exec rails hyperstack:install:hotloader        # just add the hotloader
+    >> bundle exec rails hyperstack:install:skip-hotloader   # skip the hotloader
+
+  *******************************************************************************
 rdoc_options: []
 require_paths:
 - lib
@@ -415,8 +421,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.8
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: Hyperstack for Rails with generators