Releases: micromata/generator-baumeister
Release list
4.0.2 – Deprecation release 😢
4.0.1
Bug Fixes
- baumeister: Add contents of bundleCSS to vendor CSS bundle (ff69167), closes micromata/baumeister#272
Reverts
- fix(baumeister): Initially lint files with npm start (3b16011)
See all changes since the last release.
4.0.0
Bug Fixes
- baumeister: Add missing dev dependency (c0b89a9)
- baumeister: Fix linting errors introduced by updating ESLint, plugins and configs (f38ea91)
- baumeister: Initially lint files with npm start (19e2e83)
- baumeister: Loading images via webpack (ff0b206)
- baumeister: Resolve error running tests on Node 6 (68744fe)
- baumeister: Update webpack and webpack-cli to fix build errors (c820435), closes #69
- generator: Add templates directory to lint-staged export path (82f7f84)
Features
- baumeister: Auto format code using prettier as pre-commit hook (6ea3dbf)
- baumeister: Enable to define baumeister config in package.json (fcfdc6c)
- baumeister: Move tooling configs to package.json (68f31d8), closes #270
- baumeister: Update ESLint, plugins and shared configs to their latest versions (3c6be02)
- baumeister: Update husky to v1.x.x (4f35c94)
- baumeister: Update Jest to v24.x.x and Babel to v7.x.x (7ac9da2)
- baumeister: Update production dependencies (4a54e3c)
BREAKING CHANGES
-
baumeister: Auto formatting introduces a new dev dependency which requires Node.JS
>= 8.6We are using prettier to format JavaScript, JSON and SCSS files automatically before you commit your files to Git via a pre-commit hook.
The prettier settings are defined in
.prettierrcin the project root. In case prettier is to opinated for you or you don’t want Prettier to change your files without the chance to review the changes you just have to delete the pre-commit hook with in thepackage.json:"husky": { "hooks": { "post-merge": "npm install", "pre-commit": "lint-staged" } }
But we totally recommend you to give this workflow a chance, because it’s just one more thing you don’t have to care about.
-
baumeister: Since the update to Husky v1.x.x you need to update the husky config which can be automated by running
./node_modules/.bin/husky-upgrade. See https://github.com/typicode/husky#upgrading-from-014 for details. -
baumeister: The updates of ESLint, plugins and shared configs to their latest versions might break your build since new versions have introduced new rules which might introduce linting errors in your code base.
Tip: Run
npm run eslint:fixto see which errors are autofixable. And remember to turn off rules ineslintConfigin case you find them too opinionated.
See all changes since the last release.
3.1.0
Bug Fixes
- bring back object-rest-spread babel plugin for client code (6792fb8)
- Linting error caused by updating eslint-config-xo (ac9b3a8)
Features
- Add interactive menu to list and run the most important scripts (6e97c48)
See all changes since the last release.
3.0.0
🎉 Yeah, version 3 is finally here 🎉
Let’s recap the most important changes since the last 2.x.x release:
- prompting: First class support for React SPAs (2f00fb4)
- React will be used and set up like described here when choosing to build a single page application.
- So Baumeister is able to set up:
- a static site generator (using Handlebars and Frontmatters), if you choose to build a static website.
- a React app with all the bells and whistles, if you choose to build a single page app.
- build: Replace Gulp with webpack (and npm scripts) (c6116ad)
- bootstrap: Upgrade to Bootstrap 4 (c7b4264)
-
- See Bootstrap v4 migration guide to read about the most notable as well as breaking changes.
-
- polyfills: Dynamically import and lazy load polyfills (ef5f6b5), closes micromata/baumeister#235
- This keeps the vendor bundle in modern browser smaller because
polyfills are only loaded when the used browser actually needs them.
- This keeps the vendor bundle in modern browser smaller because
Notable Changes since the last beta
Code Refactoring
- scripts: serve build via
npm run build:serve(496a15b)
Features
- add PRODUCTION constant to ESLint config (fbc804b)
- first class support for React SPAs (2f00fb4)
- improve the cacheability of the vendor bundle (d9b60e4)
- reduce noise in terminal (especially in watch mode) (46aea0b)
- setup Babel plugin transform-imports (b779eef)
- setup tree shaking (b490094)
BREAKING CHANGES
-
scripts: Changed the npm script name for serving the dist directory from
npm run build:checktonpm run build:serve -
The webpack runtime has moved into a separate file. Therefore you need to add a reference to that file into your HTML / Handlebars file(s) before the vendor bundle:
<!-- webpack runtime JS --> @@runtime.js <!-- Vendor JS --> @@vendor.js <!-- Own JS --> @@app.js
See https://developers.google.com/web/fundamentals/performance/webpack/use-long-term-caching#webpack_runtime_code for details about the why.
See all changes since the last prerelease.
Migration Guide
Below you’ll find the list of all breaking changes since the last 2.x.x release and what you have to adapt.
-
build: Gulp and all the tasks are gone. But most of the npm scripts still do what they did before. Here are the main scripts needed for developing and building your project.
Command Description npm startBuilds for development, starts a webserver, watches files for changes, rebuilds incremental and reloads your browser. npm testLints your JavaScript files and runs unit test via the Jest CLI. npm run test:watchRuns unit test with Jests watch option. npm run buildBuilds for production to distdirectory.npm run build:serveStarts a static fileserver serving the distdirectory.npm run build:analyzeStarts »Webpack Bundle Analyzer« to visualize size of Webpack output files See
scriptssection inpackage.jsonfor all available scripts. -
build: The bundled polyfills moved to the vendor bundle, the webpack runtime has moved into a separate file. Plus the references to the bundles have changed. You have to update the references in your HTML / Handlebars file(s):
<!-- Bundled vendor CSS files --> @@vendor.css <!-- Our compiled and merged Sass files --> @@app.css […] <!-- webpack runtime JS --> @@runtime.js <!-- Bundled vendor CSS files --> @@vendor.css <!-- Our compiled and merged Sass files --> @@app.css
-
polyfills: Polyfills are now dynamically imported and lazy loaded to decrease the size of the vendor bundle for modern browsers. See README for details.
-
eslint: We ’ve added eslint-plugin-unicorn and eslint-plugin-import which might introduce new linting errors. You might want to turn off rules in
/.eslintrc.jsonin case you find them too opinionated. -
baumeister.json: The properties
bundleCSSandincludeStaticFilesin baumeister.json have moved tovendor.bundleCSSandvendor.includeStaticFiles. You have to adapt these changes in case you have added dependencies via these properties. -
bootstrap: We’ve updated to Bootstrap 4. See Bootstrap v4 migration guide to read about the most notable as well as breaking changes.
See all changes since the last release.
3.0.0-beta.1
This is the last beta before the final 3.0.0 release 🎉
We are now going to address a few enhancements which might get into the final 3.0.0 release. See micromata/Baumeister#235 for details.
Notable changes
Bug Fixes
- Open Webpack dev server with --host flag (1ae864e)
- Referencing fonts from within Sass files (9cd84e9), closes micromata/baumeister#236
Features
- Dynamically import and lazy load polyfills (ef5f6b5), closes micromata/baumeister#235
See all changes since the last release.
3.0.0-beta.0
This is the first beta of the 3.0.0 release 🎉
Install with:
npm install -g generator-baumeister@prerelease
We have a few enhancements which might get into the final 3.0.0 release. See micromata/Baumeister#235 for details.
Notable changes
Code Refactoring
- baumeister.json: Rename properties related to vendor files (a594563)
Features
- remove Yarn lockfiles 👋🏻 (b6f1fbf)
- eslint: Simplify setup and include two additional plugins (f039c24)
- Replace Gulp with Webpack (and npm scripts) (c6116ad)
- Upgrade to Bootstrap 4 (c7b4264)
BREAKING CHANGES
-
Gulp and all the tasks are gone. But most of the npm scripts still do what they did before. Here are the main scripts needed for developing and building your project.
Command Description npm startBuilds for development, starts a webserver, watches files for changes, rebuilds incremental and reloads your browser. npm testLints your JavaScript files and runs unit test via the Jest CLI. npm run test:watchRuns unit test with Jests watch option. npm run buildBuilds for production to distdirectory.npm run build:checkStarts a static fileserver serving the distdirectory.npm run build:analyzeStarts »Webpack Bundle Analyzer« to visualize size of Webpack output files See package.json scripts section for all available scripts.
-
The polyfills bundle is gone and the references to the bundles in default.hbs respectively the HTML files has changed to:
<!-- Bundled vendor CSS files --> @@vendor.css <!-- Our compiled and merged Sass files --> @@app.css <!-- Vendor JS --> @@vendor.js <!-- Own JS --> @@app.js
-
We switched from using UnCSS to PurifyCSS for remo0ving unused CSS.
Due to the concept of Webpack we only generate one CSS bundle. PurifyCSS is turned off by default.To activate PurifyCSS set the
usePurifyCSSoption in withinbaumeister.jsontotrue.
In addition you can define a PurifyCSSwhitelistdefining an array of selectors that should not be removed. -
eslint: We’v added eslint-plugin-unicorn and eslint-plugin-import which might introduce new linting errors. You might want to turn off rules in
/.eslintrc.jsonin case you find them too opinionated. -
baumeister.json: The properties
bundleCSSandincludeStaticFilesin baumeister.json are moved tovendor.bundleCSSandvendor.includeStaticFiles. You have to adapt these changes in case you have added dependencies via these properties. -
See Bootstrap v4 migration guide to read about the most notable as well as breaking changes.
See all changes since the last release.
2.0.1
Bug Fixes
- adapt breaking changes of updated dev dependencies (874b294)
- copy additional directories in src/assets to build directories (0af86b4)
- update dependencies of generated project (d8a9780)
- Update dependencies of the generator (d1e1d41)
- update dev dependencies of the generated project (62067f7)
See all changes since the last release.
2.0.0
Bug Fixes
- Update dependencies of the generator (83a3baf)
- prompting: Fix broken prompt for theme name 🙈 (482ecae)
- readme: Print the chosen license in the README (cbf61ac)
Features
- prompting: Remove prompt to rename output directory (4809822)
Chores
-
Adapt changes from Baumeister 2.0.0. (ee4f731)
Bug Fixes
- update dependencies (2722663)
- update dependencies (#199) (9d41b6d)
- config: prevent error if
includeStaticFilesis empty (3ce7eb5), closes #215 - linting: fix linting errors introduced with eslint-config-xo (389e07b)
- update dev dependencies (d96c53e)
- update dev dependencies (b072aa8)
- linting: fix stylelint errors (62a4087)
- settings: revert generateBanners setting to false (68eebf5)
Code Refactoring
Features
BREAKING CHANGES
Yeoman Generator
- prompting: You aren’t able to customize the name of the
distdirectory while scaffolding your app. You can still customize it after scaffolding by changing the directory in/gulp/config.js.
Generated projects via Baumeister 2.0.0
- linting: The new major version of
stylelint-config-standardintroduces
some new rules which might break your build. Therefore you might
need to adapt your code or disable unwanted rules in.stylelintrc.json. - bundling: The bundles are renamed (and partly removed) to:
app/polyfills.bundle.js,app/vendor.bundle.jsandapp/app.bundle.jsand must be included via script tags in that order. See default.hbs. - settings: Settings moved from
package.jsonto the newbaumeister.jsonconfig file in the project root. In addition the two boolean settingsuseHandlebarsandgenerateBannersfromgulp/config.jsare also exposed to thebaumeister.json. - linting:
eslint-plugin-filenameswill cause linting errors in case you already have JavaScript files with filenames written in camelCase. You have to rename those files or change/disable the rulefilenames/match-exportedin.eslintrc.jsondepending on your preference.
See all changes since the last release.