Getting started

Installation
Ensure you have Webpacker and React installed. Add the following to your Gemfile and run bundle
1
# Gemfile
2
gem 'superglue'
Copied!
Run the installation generator
1
rails superglue:install:web
Copied!
Generate a scaffold
1
rails generate scaffold post body:string --force --no-template-engine --superglue
Copied!
Configuration
The rails superglue:install:web step adds a preconfigured entry point in app/javascript/packs/application.js.
Custom Reducers
The generator will also add a reducer.js file for any custom reducer you'd like to add. Included in the reducer is a pagesReducer for any cross-page optimistic updates, and a applicationRootReducer for the entire store. The latter is used for Redux Persist, which you can customize to your needs.
Custom Visit and Remote
The visit and remote thunks can be customized in app/javascript/packs/application_visit.js. Functionality like loading indicators can be added there.
Configuring Reloads
Superglue will do a hard reload whenever a successful response returns new asset fingerprints. Add an initializer to control how Superglue tracks Sprockets and Webpack assets:
1
# defaults
2
Superglue.configure do |config|
3
  config.track_sprockets_assets = ['application.js', 'application.css']
4
  config.track_pack_assets = ['application.js']
5
end
Copied!

Demo Application

navigation

Last modified 16d ago

Copy link

Contents

Installation

Configuration

Custom Reducers

Custom Visit and Remote

Configuring Reloads