GlueStick is now archived. It was one of the first React-in-a-box projects and helped TrueCar quickly migrate to React. With the React community growing and changing so quickly, it became difficult for TrueCar to keep GlueStick up to date. Thank you to all the contributors that helped along the way!
If you're interested in this type of project, we recommend NextJS, which provides server rendering along with many other features GlueStick offered.
GlueStick - Beyond the Boilerplate
GlueStick is a command line interface for quickly developing universal web applications using React and Redux.
Why is your project or boilerplate not enough?
- You need integrated updates. Without integrated updates, you are forced to manually merge in new features/fixes.
- Integrated dockerization. Go from development to production as simply as
gluestick dockerize MyApp
- Automatic test framework setup. Preloaded with
Enzymeright out of the box
- Built in best practices. Things like code splitting, hot module replacement, react-router, etc
- Rails-like generators for common needs like components/reducers/containers/etc, with all necessary hooks and tests
GlueStick allows users to quickly create new applications with its bootstrap generator, along with generators for components, containers, and reducers. In addition, GlueStick contains a fully functional test environment, server-side rendering, and an asset bundler. However, GlueStick sidesteps the hassle of any configuration files.
The goal is not to be another boilerplate for building universal web applications. Instead, the goal is to abstract all of the boilerplate code into one location that the developer doesn't have to worry about. Not only does this make your application code cleaner but it makes it easier to update the boilerplate code as new improvements are discovered.
Gluestick is actively worked on, supported and used in production by TrueCar.
What about Create React App?
Create React App is an excellent command line interface for creating React applications. Gluestick is a much more opinionated tool, which offers several features out-of-the-box (pre-configured) that Create React App does not (and in some cases would require ejection from Create React App), such as:
- Code splitting
- Server rendering
- React Router and Redux implementation
- Generators for standard development needs
npm install gluestick-cli -g gluestick new SampleProject cd SampleProject gluestick start
Docs & Help
- Webpack Bundle Analyzer Guide
- Contribution Guidelines
Terms & Definitions
Gluestickis a monorepo. It is published to npm with
Lernaand contains depdent modules or "packages" for building Gluestick apps. The Gluestick repo uses Lerna 1,2 to help break what would otherwise be a potentially large code base in to smaller, versioned packages.
gluestick-cli- A package in the Gluestick monorepo that acts as a thin wrapper for managing Gluestick apps from the command-line. With it you can create an app, destroy it, auto upgrade all of its dependent packages, etc... It has a few commands of its own, but several are proxied to your local Gluestick package.
gluestick- A package in the Gluestick monorepo that provides additional command line functionality for building for universal-React apps as well as the internals (guts) for driving the Gluestickm Universal React apps themselves.
Q: The main project is called "Gluestick", but the binary is called "gluestick-cli", but there's a package in the main project called "gluestick". What's up with that?
A: Gluestick is a monorepo.
gluestick-cli is a sub-package in that repo that is deployed to
npm and is used to manage Gluestick apps.
gluestick (little 'g') is also a sub-package and contains the guts of Gluestick applications.