Production Builds

Use the Production Build

If you’re benchmarking or experiencing performance problems with gymnast, make sure you’re testing with the minified production build.

By default, gymnast includes many helpful warnings. These warnings are very useful in development. However, they make it larger and slower so you should make sure to use the production version when you deploy the app.

Single-File Builds

We offer production-ready versions of gymnast as a single file:

<script src=""></script>

Remember that only gymnast.min.js is suitable for production.


For the most efficient webpack production build, make sure to include these plugins in your production configuration:

new webpack.DefinePlugin({
  'process.env.NODE_ENV': JSON.stringify('production')
new webpack.optimize.UglifyJsPlugin()

You can learn more about this in webpack documentation.

Remember that you only need to do this for production builds. You shouldn’t apply UglifyJsPlugin or DefinePlugin with 'production' value in development because they will hide useful gymnast warnings.