razzle

Consider it experimental for now

To try it now:

npx create-razzle-app@finch testing --ignore-existing
cd testing
yarn add [email protected] --dev
yarn start
yarn build
yarn start:prod
yarn export 
yarn start:static
yarn test

See the docs

Major Changes

• Fix: no 8.x or 9x node: d2fe6a27bc4915932adf1b86035a8e898e1337af
• Fix: update examples dependencies: 6ec2f788e99083bb677777c58648ab954d0a99bd
• Fix: add dependencies: 6c808e09cf04fe7542fbf1234ea1470319b1ce8e
• Chore: update dependencies: 863e045e8046b96bec7c3119ca7e3b8a48aa4af7
• Chore: update dependency versions: 1a9fab58f414966298a18277fec15c81844424c4
• Chore: update postcss dependencies: 668321bfc67da631cc048dea46d38a1e0bc610bd
• Feat: add webpack 5 support: e10bef20828cc70bf387fd96401a3529c072013a
• Fix(razzle): new dependency version: c0bab49a3028870d39493cc5bcf3341fdfdb82b2
• Feat(razzle): use options instead of cli args: 0ea02813ee17a3b53e92d0bfb41af72c81715db1
• Fix: use jest in top package: 1e9e479e60897ef3e86d23463ebbc77e621cb4d9
• Chore: upgrade jest: b45a6800bdf5e22a13d186c97db58781dba694bc

Minor Changes

• Fix: razzle allow toggling warnings as errors: 8c49e47c8dda49b5fe75a830e5e0dfe818b58279
• Fix(razzle): use paths.appPath with libIdent: 4a61e0dc32c5b9843bf879568620323552b92b93
• Dev-infra: better branch logic: 328358cae136ace0bcae5cba1b341a6fc58b541e
• Fix(razzle): make more options overridable: 1dc13db4f5e67beb48b1a92a431bee8b9c7a4b58
• Fix(razzle): correct options to StartServerPlugin: 5f134844eab8a3b1cc0e8ec772766d4157a7a7cd
• Fix: fix issue with commonjsplugin and postcss-loader: a4d61c9fcd9e4ab9eed6dcce7999f195156996a8
• Fix(razzle): silence startserverplugin: 03a604a55a0adb9e5441e19ae55831d15c22d851
• Fix: load options correctly, use fs in tests, set clientonly: a03b4beb4051eba4fef2903712c76f8db0aced09
• Fix: make more options overridable, clean up old preset, document babel config: 217e196840b755bf01084279508de9af50fc75cf
• Fix: allow getting string only loaders: f80748ec313abe96d995fb73be297fa3e42914f3
• Fix(razzle-dev-utils): add missing dep: 65cfa689e9cc5f95e7a1586b44a0959fb56d87d3
• Dev-infra: allow finch release: 25f72560411cf304790cfc0cd51f56a000ed8d6c
• Fix: no jest in plugins: b5ea5196c03eda5b65abcaebbb9e81ced808d886

Patches

• Fix: add back readme that got lost: da7a271ff567740f53af5346af9713a1fae918df
• Fix(razzle-dev-utils): setPorts did not set port in async: 878520a71bf693a2bf4b1393c8e2b1058a5136d4
• Fix: razzle allow toggling warnings as errors: bb07b9ecd20a3c586f6630c7dd31d3aad6fa0716
• Dev-infra: disable warnings as errors: 6bc95201f7a384b9eb1e2c9b9364fed095bc98a5
• Chore: update yarn lock: 4bf0ac1578403e118469fd043bdd2e91fa7a641d
• Fix: keep node 8 compatibility: 6b74b84d473195fc63951ccaf6fde4207bbcefcb
• Fix(razzle): use paths.appPath with libIdent: d19436bbe3b54e31b5fc2a143cac0d69363acd6d

Patches

• Fix: upgrade all the package deps: dea55019a18e0c1f14e6ca79755a49a5cbfe5292

Patches

• Fix: undo replacement that went bad in dev scripts: ec827caa0f44c22896346fa04dc55d9d9e0bd61b

Patches

• Fix: fix inter-package dependenciees: bd2702cd98612e2243f08bbfe472e8ad236b3be2

Patches

• Fix(create-razzle-app): fixed a merge conflict: b6c00fb9bc9445098568392a28166be88b403b0f

This is meant to prepare you for Razzle 4.0.

If you enable all the experimental features added you are better prepared for Razzle 4.0 where these features are defaults.

Will do a 3.4.0 release right after 3.3.0 stable is out with security related package upgrades.

After that there will be a 4.0.0 canary release.

// razzle.config.js
'use strict';

module.exports = {
  experimental: {
    newBabel: true,
    newExternals: true,
    newSplitChunks: true,
    newContentHash: true,
    newMainFields: true,
  }
};

To try it now:

npx create-razzle-app@canary --example with-all-experimental testing --ignore-existing
cd testing
yarn start
yarn build
yarn start:prod
yarn export 
yarn start:static
yarn test

See the docs

Minor Changes

• Feat(razzle): add new externals resolution as a experimental feature: e169b1eea64851fc475f8f0c97047dfa7b376497
• Feat(razzle): add new babel configuration: 6d91a4ec2d9b5a9e5f01e22a4fce21ab1a0adcce
• Feat(razzle): add razzle export to export static site: 1336cd20fb9e5e63af26f3b6879c4d5abb6ced23
• Feat(razzle): test jest version in config validatio, fix issue with async: 2598131222545be12628b34230c11bff433e14a5
• Feat: add new plugin system with more hooks: b28a88ec5677bfa2bacde166b316646e4fc149ee
• Feat: add experimetal support for new splitChunks config, add all-experimetal example: b9d7626d7f3deecc63456c0f408e413cfc30cc9b
• Fix: use camelcase for all options: 010b8b7df8c335e2413e05e25d44b122e3cf5361
• Feat: add mainFields configuration, make contethash toggleable: f52130042f5175484c7324ea12d55d316b3d3567
• Feat(razzle): add Yarn PnP support: 98377c4d08fd611f0daccc94d8c4c32f00e2cb33
• Fix: get some default options from package.json: 8831cbd68021f83717cbf5a546ac6920cc38ed55
• Fix: respect browserslist: fb4362298583e96044451d945090577a9ffcdeb9
• Fix(razzle): use copy-webpack-plugin to copy from public dir: c5f4bc3f7ed41caf2fd4fcc307d1ba40ab6e52de
• Feat(razzle): add a option to enable serverless builds: 99d49d90dda63910cc5d45b4071da4aa9b43c19c
• Feat(razzle): add assets-manifest: 1c6e9169e9d8eee256d0f118f8a88da8de85989f

Patches

• Fix(razzle): add a missing dependency and require: 4c0f0b005f86c82c444cf9abeba0865ffbd1bc1e
• Fix(create-razzle-app): respect branch in install: 1d92913341fbaf37062b2a1bdf1f0babbc916f7e
• Fix(razzle): make new babel config work properly: a6ad3aec82ec7dd178057a95ff3c72ae07f32bb2
• Fix(create-razzle-app): reverse the logic for razzle version tag: b39ad49b7b39834e23d3745323399c4c4cd364c2
• Feat: use contenthash instead of chunkhash and hash: 45140ebd7161df507212656809917578d115cba7
• Fix: disable react-refresh in prod: e651211ffb2f58e2c34db51c7c37fdaa652552db
• Docs(plugin-typescript): add link to example: 21b76507036281f985b591df560d708492381220
• Fix(razle-dev-utils): add missing webpack-dev-server dependency: d38b492ab1a2b87689db07fbfa82f8ad5f071ad0
• Fix: bundle babel runtime: 1ac9f13c912c333b4a80cadddbe7f2485e7933ab
• Chore: downgrade dep until razzle 4.0: b97f4175c60ed3262ebfa5a38eae261ac454371c

Patches

• Fix(razle-dev-utills): add missing webpack-dev-server dependency: 417cff5377961f21f16e6b974277f94d373914e5

Patches

• Fix(create-razzle-app): get examples list from correct branch: 1bfc0fb282be46392d265264fb9dc86484ed16bc

Patches

• Fix(create-razzle-app): respect branch in install: 22e00e95d05e48b6ea0b08b09ed50fed080d1646

Patches

• Fix(razzle): add a missing dependency and require: 894725f4c165805f6d7e8193101a1947789a98d0

Here are some of the fixes and new features.

feat(razzle): make configuration promise based
fix: deprecate createConfig so plugin tests have time to update before next major release
feat(razzle): add support for typescript to razzle core
fix(css): make sure only one mini-css-extract-plugin is present
fix(razzle): fix issue with DEV_PORT env var and client only razzle start
feat(razzle): support paths in jsconfig and tsconfig
feat(create-razzle-app): add support for npm/github/git/file example templates
feat(less/scss): support postcss.config js and modules in less and scss plugin
feat(razzle): add support for postcss.config.js
feat(razzle): add experimental support for react-refresh
feat(examples): add with-single-exposed-port example

Patches

• Fix: updated spa example with working env var: fd852abd36b0cfdb139434176c681f18f10774f1
• Fix(css): add back localIdentName to css modules: 999a2c1f65bcf49f0ce968a3b130b0416000959e
• Fix(css): add one more missed localIdentName: eea3ac3cda299d4338af71f02f692377faa142e7
• Docs: update getting started duplicate paragraphs: a75b0a225abf54074916130b50b611caf29949d3
• Fix(razzle): manifest chunk name fallback to entry.id: fb2d3087ce0b503baa6549823ef2e2353cd3a4e1

Patches

• Fix(scss): add mini-css-extract-plugin to peerDependencies to fix npm install: 018811309c2be36e4d4159f9f2ffd88440be6ab7

Patches

• Fix(css): make sure only one mini-css-extract-plugin is present: eca432c694689b5775eb05243aeccf7daa287a56

Patches

• Fix(razzle): logger import: #1299

Credits

Huge thanks to @sumanbh for helping!

Patches

• Fix: complement CSS loader setup with pre-3.1 configuration

This is a patch release to fix some issues in 3.1.0

Patches

• Update README.md
• Fix(test): master branch
• Updating Examples: #1278
• Fix: scss modules build: #1281
• Fix: correct formatting of --inspect/inspect-brk in start script

Credits

Huge thanks to @nimaa77 for helping!

Long time no see

A new release after a long time, but no worries we have ci/cd for deployments now so we can tag a new release any time that we want. 🚀 (maybe two releases per month)

and we are working on razzle to make it the best SSR solution that you may ever find on Github.

if you need any new features or you had any questions ❓ feel free to open an issue, I and @fivethreeo are happy to help you guys.

What's new

1. SPA mode
   In addition to universal/isomorphic applications, Razzle can build a single page (or client-only) applications. To do this, you can remove index.js and server.js then index.html file inside the public folder at the end pass --type=spa to your package.json's scripts like so:

"scripts": {
-  "start": "razzle start",
+  "start": "razzle start --type=spa",
-  "build": "razzle build",
+  "build": "razzle build --type=spa",
  "test": "razzle test --env=jsdom",
-  "start:prod": "NODE_ENV=production node build/server.js"
+  "start:prod": "serve -s build/public"
}

https://github.com/jaredpalmer/razzle#build-types
2. Absolute Imports
create a new jsconfig.jsonfile in root of the project

{
  "compilerOptions": {
    "baseUrl": "src"
  },
  "include": ["src"]
}

and then you can use import files directly from src directory:

import Button 'components/Button';

(also works with typescript and tsconfig.json)

3. razzle-plugin-scss: now you can use CSS modules with sass files

import styles from './home.module.scss'

4. Expanding Environment Variables In .env

# .env file

DOMAIN=www.example.com
RAZZLE_FOO=$DOMAIN/foo
RAZZLE_BAR=$DOMAIN/bar

Note

Minor Changes and Patches are not complete in this list there many more, some of them listed here

Minor Changes

• Eat webpack-dev-server logs: #1255
• Update jest.config.json: #1259
• Merge branch 'next': c3422de4f91a2f869502edac0c101996c26391bb

Patches

• Fix(scss-plugin): use onlyLocals option: #1254

Credits

Huge thanks to @fivethreeo for helping!