.gitignore

@@ -2,3 +2,5 @@ node_modules
 lib
 tmp
 npm-debug.log
+package-lock.json
+yarn.lock

.travis.yml

@@ -1,23 +1,52 @@
 language: node_js
-node_js:
-- 6.9.2
-- 7.3.0
-sudo: false
+
 before_install:
-- curl -o- -L https://yarnpkg.com/install.sh | bash # until yarn is
-- export PATH=$HOME/.yarn/bin:$PATH                 # pre-installed
+  - curl -o- -L https://yarnpkg.com/install.sh | bash # until yarn is
+  - export PATH=$HOME/.yarn/bin:$PATH                 # pre-installed
+
 script:
-- node bin/ci.js
-env:
-  matrix:
-  - TEST_TYPE=lint_and_test_unit
-  - TEST_TYPE=integration_test
-  - TEST_TYPE=test_create_project_npm
-  - TEST_TYPE=test_create_project_yarn
+  - node bin/ci.js
+
+matrix:
+  include:
+    - sudo: false
+      env: TEST_TYPE=lint_and_test_unit
+      node_js: 6.11.1
+
+    # test creating a new project with the LTS version
+    - sudo: false
+      env: TEST_TYPE=test_create_project_npm
+      node_js: 6.11.1
+
+    # test creating a new project with the latest version
+    - sudo: false
+      env: TEST_TYPE=test_create_project_npm
+      node_js: 8.4.0
+
+    - sudo: false
+      env: TEST_TYPE=test_create_project_yarn
+      node_js: 6.11.1
+
+    # Test with Chrome available
+    - dist: trusty
+      addons:
+        chrome: stable
+      sudo: false
+      env:
+        - TEST_TYPE=integration_test
+        - BROWSER=Chrome
+      node_js: 6.11.1
+
 cache:
   directories:
-  - node_modules
+    - node_modules
+
+before_deploy:
+  - npm prune
+  - npm run build
+
 deploy:
+  skip_cleanup: true
   provider: npm
   email: paulo@ragonha.me
   api_key:

README.md

@@ -1,3 +1,11 @@
+## Deprecated
+
+When Sagui was created, the frontend landscape was in a much different situation than it is today. Creating projects was a hell and we all faced the now infamous "JavaScript fatigue". Fast-forward to 2019 and we now have established solutions such as [create-react-app](https://github.com/facebook/create-react-app) that have a large community behind and is being well maintained. Therefore there is no longer a need for Sagui to exist.
+
+This was a fantastic ride and I've learned a lot while building this little tool.
+
+Thanks to all the community who help me along the way! ❤️🐒
+
 ![Sagui](https://raw.githubusercontent.com/saguijs/sagui/master/banner.jpg)
 
 [![Build Status](https://travis-ci.org/saguijs/sagui.svg)](https://travis-ci.org/saguijs/sagui)
@@ -25,7 +33,7 @@ npm init -y
 **Install Sagui locally** as a development dependency:
 
 ```bash
-npm install --save-dev sagui@beta
+npm install --save-dev sagui
 ```
 
 Start the development server:
@@ -56,8 +64,10 @@ Sagui manages the [package.json](https://docs.npmjs.com/files/package.json) scri
 
 - `npm run build`: build a development version of the project;
 - `npm run dist`: build an optimized (ready for deployment) version of the project;
-- `npm run start`: spin up a development server with live-reload and [HMR](http://webpack.github.io/docs/hot-module-replacement.html);
+- `npm run start`: spin up a development server with live-reload and [HMR](https://webpack.js.org/concepts/hot-module-replacement/);
+- `npm run format`: automatically format the code using [prettier](https://github.com/prettier/prettier);
 - `npm run test`: run all test related scripts below;
+- `npm run test:lint`: run static analysis in the code;
 - `npm run test:unit`: run the unit tests;
 - `npm run test:typecheck`: run the static type analysis in the code;
 - `npm run test:unit:watch`: run a test watcher (great for development and debugging).
@@ -72,11 +82,9 @@ As stated earlier, Sagui strives to provide all the basic needs to create modern
 
 The development server out-of-the-box has live reloading and **hot-module replacement**.
 
-[ReactJS](http://reactjs.com/) has first-class support via [react-transform](https://github.com/gaearon/babel-plugin-react-transform), so updating components' source reflects instantly (without full refresh) in the browser.
-
 ### Build
 
-Sagui uses [Webpack](http://webpack.github.io/) as its underlying bundling tool. The biggest feature that Webpack provides is that everything is a module. Sagui supports the following module types by default:
+Sagui uses [Webpack](https://webpack.js.org/) as its underlying bundling tool. The biggest feature that Webpack provides is that everything is a module. Sagui supports the following module types by default:
 
 - Fonts (`.woff`, `.woff2`, `.ttf`, `.eot`, `.otf`)
 - HTML (`.html`)
@@ -91,7 +99,7 @@ Sagui uses [Webpack](http://webpack.github.io/) as its underlying bundling tool.
 During build, optimizations and special processing are also performed in the output bundle:
 
 - [Autoprefixer for CSS properties](https://github.com/postcss/autoprefixer) for cross-browser support;
-- [Commons code splitting](https://webpack.github.io/docs/list-of-plugins.html#commonschunkplugin) if there is more than a single entry-point;
+- [Commons code splitting](https://webpack.js.org/plugins/commons-chunk-plugin/) if there is more than a single entry-point;
 - [Extract styles as separated files](https://github.com/webpack/extract-text-webpack-plugin) to style the page before the JavaScript is loaded and parsed;
 - Minification and code dedupication.
 
@@ -108,13 +116,32 @@ Sagui will automatically run every test file that follows this convention.
 
 Under the hood it uses [Karma test runner](http://karma-runner.github.io/) to allow running the tests in the most diverse browsers and even through [Selenium](http://docs.seleniumhq.org/) (not natively).
 
-By default Sagui uses [PhantomJS](http://phantomjs.org/) to run the tests headlessly. To **speed up installing the dependencies** (`npm install`) it is advisable to have PhantomJS [installed globally](https://github.com/Medium/phantomjs#using-phantomjs-from-disk) in the machine.
+To run the tests Sagui uses [Chrome Headless](https://chromium.googlesource.com/chromium/src/+/lkgr/headless/README.md), but it fallbacks to [PhantomJS](http://phantomjs.org/) if Chrome is not installed on the machine.
+
+Make sure either of these browsers is installed to be able to run the tests:
+
+- [Chrome](https://www.google.com/chrome/browser/desktop/index.html)
+- [PhantomJS](https://github.com/Medium/phantomjs#using-phantomjs-from-disk)
 
 To open the tests in a browser (or in multiple browsers!), simply follow the link Karma outputs when you start running the script `test:unit:watch`. Running them in a browser allows you to set breakpoints and debug your code properly. Note watch mode is necessary, else tests will stop running when finished.
 
-#### Linting
+#### Code formatting
+
+We expect the code to be formatted using [prettier](https://github.com/prettier/prettier). Sagui has a script that can apply the expected code format for you, simply run:
+
+```bash
+npm run format
+```
+
+To get the code formatted automatically for you, it is recommended that you install the [prettier plugin](https://atom.io/packages/prettier-atom) in your editor of choice with the same configuration that is used by Sagui:
+
+- singleQuote: `true`
+- parser: `babylon`
+- semi: `false`
+- printWidth: `100`
+- trailingComma: `es5`
 
-Static code analysis is also performed on the code following the [JavaScript Standard Style](http://standardjs.com/) convention.
+Prettier is combined with the [JavaScript Standard Style](http://standardjs.com/) convention to check for common errors in the code.
 
 #### Static type checking
 
@@ -153,6 +180,43 @@ The previous configuration will expect and build the files:
 - `src/index.html` => `dist/index.html`
 - `src/index.js` => `dist/index.js`
 
+#### Excluding a page from chunks
+
+If you want a page to be excluded from either the [vendor](#chunksvendor) or [common](#chunkscommon) chunk, then you can do so by providing an object with a `name` and `independent` flag (set to `true`) instead of just the name of the page.
+
+```js
+// sagui.config.js
+module.exports = {
+  pages: ['index', 'about', { name: 'demo', independent: true }]
+}
+```
+
+### `chunks.vendor`
+
+If you want all your external dependencies (`node_modules`) in your [pages](#pages) to be bundled together in a "vendor" chunk, then set this flag to `true`. By default it is set to `false`.
+
+```js
+// sagui.config.js
+module.exports = {
+  chunks: {
+    vendor: true
+  }
+}
+```
+
+### `chunks.common`
+
+If you do not want all the common dependencies of your [pages](#pages) to be bundled together in a "common" chunk, then set this flag to `false`. By default it is set to `true`.
+
+```js
+// sagui.config.js
+module.exports = {
+  chunks: {
+    common: false
+  }
+}
+```
+
 ### `libraries`
 
 Create **reusable libraries** that can be shared across applications. Sagui will take care of the build process so that external libraries are not bundled and that you have a CommonJS module as the output.
@@ -395,6 +459,19 @@ For more information about configuring Karma, check the [Karma documentation](ht
 
 ## Gotchas
 
+### `Invalid Host header` - Accessing dev server from outside `localhost`
+
+By default, Webpack disables access to the development server for hosts other than `localhost`, which means the development server will not be accessible from outside. If you want to give external access to the development server, you can set the `develop.disableHostCheck` to `true`:
+
+```js
+// sagui.config.js
+module.exports = {
+  develop: {
+    disableHostCheck: true
+  }
+}
+```
+
 ### React Router
 
 For [`react-router`](https://github.com/ReactTraining/react-router) to work on the development server, an absolute static path for the output has to be configured on Webpack. You can do that by adding this configuration to `sagui.config.js`:

appveyor.yml

@@ -3,15 +3,15 @@ version: "{build}"
 
 environment:
   matrix:
-    - nodejs_version: "6.2.0"
+    - nodejs_version: "8.1.4"
       platform: x64
       TEST_TYPE: lint_and_test_unit
 
-    - nodejs_version: "6.2.0"
+    - nodejs_version: "8.1.4"
       platform: x64
       TEST_TYPE: integration_test
 
-    - nodejs_version: "6.2.0"
+    - nodejs_version: "8.1.4"
       platform: x64
       TEST_TYPE: test_create_project_npm
 

bin/ci.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 var path = require('path')
 var saguiPath = path.join(__dirname, '..')
+var version = require('../package.json').version
+var tgzFile = path.join(saguiPath, `sagui-${version}.tgz`)
 
 console.log('ENVIRONMENT', process.env)
 
@@ -26,31 +28,37 @@ if (process.env.TEST_TYPE === 'integration_test') {
 if (process.env.TEST_TYPE === 'test_create_project_npm') {
   // # builds Sagui before installing
   exec('npm run build', saguiPath)
+  exec('npm pack --ignore-scripts')
 
   var npmProjectPath = createTempFolder()
 
   // # Create a new project and install Sagui
   exec('npm init -y .', npmProjectPath)
-  exec('npm install --save-dev file://' + saguiPath, npmProjectPath)
+  exec(`npm install --save-dev ${tgzFile}`, npmProjectPath)
 
   // # Run some basic scripts
   exec('npm test', npmProjectPath)
+  exec('npm run test:lint', npmProjectPath)
   exec('npm run build', npmProjectPath)
   exec('npm run dist', npmProjectPath)
+  exec('npm run format', npmProjectPath)
 }
 
 if (process.env.TEST_TYPE === 'test_create_project_yarn') {
   // # builds Sagui before installing
   exec('npm run build', saguiPath)
+  exec('npm pack --ignore-scripts')
 
   var yarnProjectPath = createTempFolder()
 
   // # Create a new project and install Sagui
   exec('yarn init -y .', yarnProjectPath)
-  exec('yarn add --dev file://' + saguiPath, yarnProjectPath)
+  exec(`yarn add --dev ${tgzFile}`, yarnProjectPath)
 
   // # Run some basic scripts
   exec('yarn test', yarnProjectPath)
+  exec('yarn run test:lint', yarnProjectPath)
   exec('yarn run build', yarnProjectPath)
   exec('yarn run dist', yarnProjectPath)
+  exec('yarn run format', yarnProjectPath)
 }