JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 4449
  • Score
    100M100P100Q122574F
  • License MIT

An NPM package for adding post build compression to a create-react-app builds

Package Exports

  • compress-create-react-app

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (compress-create-react-app) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

npm version npm monthly downloads

Make your apps smaller by adding post build compression to your create-react-app build without configuration.

Compresses all html, css and javascript files in the build folder using brotli and gzip algorithms.

Feel free to create an issue for any problems you've had or if you want to request a new feature.

Usage

0) Create your app using create-react-app

1) Installation

Install the package as a dev dependency:

npm install compress-create-react-app --save-dev

2) Usage

Edit your app's build script in package.json:

  "scripts": {
    "start": "react-scripts start",
-   "build": "react-scripts build",
+   "build": "react-scripts build && compress-cra",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  }
Custom build directory

Since version 1.1.0, you can optionally provide a path to your build directory by adding -d or --directory argument to the command in your package.json:

...
"build": "react-scripts build && compress-cra -d /path/to/build",
...

The default build path is /build. The provided custom path should be a relative path from your project's root directory.

3) Build your app just like you normally would

npm run build

4) Make your server serve the compressed files

The way to set up your server highly depends on the server you use.

As an example, here's how I set up an express server using express-static-gzip:

npm i express-static-gzip
const express = require('express');
const path = require('path');
const app = express();
const PORT = process.env.PORT || 5000;
const expressStaticGzip = require('express-static-gzip');

app.use(express.json({ extended: false }));

// API paths
app.use('/api/auth', require('./routes/auth'));
app.use('/api/posts', require('./routes/posts'));
app.use('/api/users', require('./routes/users'));

// Serve the build files
const buildPath = path.join(__dirname, '..', 'build');
app.use(
  '/',
  expressStaticGzip(buildPath, {
    enableBrotli: true,
    orderPreference: ['br', 'gz']
  })
);

// Fallback to index.html when something that doesn't exist is requested
app.get('/*', (req, res) => {
  res.sendFile(path.join(__dirname, '..', 'build', 'index.html'), err => {
    if (err) {
      res.status(500).send(err);
    }
  });
});

app.listen(PORT, () => console.log(`Server started on port ${PORT}`));

Contributing

This is a small project that is currently maintained by one person. There are no strict contributing guidelines. If you're interested in contributing, see if there are any issues you could help with or post a new one to suggest a feature.

Donations

Due to Finnish laws, I can't accept direct donations. If you want to support the development of this package, you can buy a written greeting from me for 5€ (US $6):

  1. Send the payment for the greeting via PayPal.
  2. Send the receipt to joonas@joonasjokinen.fi and you will receive your greeting within a week.

License

This app is licensed under the MIT License.