starbase is a production-ready website boilerplate built with webpack 5, Babel 7 & Sass that enables developers to get up and running in minutes using some of the most powerful front-end tools available in 2022:
The primary mission is to be small in scope so that it may be easily extended and customized, or used as a learning tool for developers who are trying to become familiar with webpack 5, Sass and/or modern JS.
After completing the steps below, you will be ready to begin using starbase:
- Install Node.js (latest LTS recommended)
- Clone starbase into your project root directory
- Install dependencies by running
npm installin your project root directory
npm run start in the project root, your
/src code will be served at the url above and watched for changes. As you modify code in
/src, the project will be recompiled and your browser will refresh to show the latest changes.
cd /path/to/starbase npm run start
Building for Production
npm run build in your project root to run a production build.
Production builds compile & minify your assets into
/dist for distribution and/or integration into whatever codebase you'll be using these assets in.
cd /path/to/starbase npm run build
Features & Configurations
JS & Sass Linting
/.stylelintrc respectively) include a solid foundation to build upon, utilizing the most popular industry-standardized plugins such as eslint-config-airbnb and stylelint-config-sass-guidelines.
starbase uses Prettier to enforce and simplify code consistency. If you use VS Code, check out the Prettier VS Code extension. If you'd rather prettify your code via CLI, run
npm run prettify at your project root.
Linting & Formatting Pre-Commit Hook
HTML Webpack Plugin
starbase uses HTML Webpack Plugin, which enables webpack to handle assets that are linked from within our HTML templates, such as images and embedded videos. It also makes sure our generated
.css files are included where they need to be.
Open the webpack configs if you need to add more pages -- and be sure to check out the plugin documentation to learn about the more advanced features such as
.ejs and environment variable support.
Asset Hashing (Cache Busting)
The assets generated by starbase are hashed as a cache-busting mechanism. Hashes are generated via file contents so they will only change when the files themselves have changed.
This feature ships with webpack (and the loaders we use), so removing it is pretty straightforward. Open the webpack configs and remove the hashes from the filenames, which should look something like this:
Removing hashing for production builds is not recommended.
starbase is setup to clear all contents of
/dist (where compiled assets are piped into) during each
npm run build. If you'd like to remove this part of the build process, perform the following steps:
CleanWebpackPluginfrom the plugins array in
CleanWebpackPluginas a requirement at the top of
- remove the
Removing the cleanup process means that deleted assets in
/src will not be deleted in
/dist until you manually do so. I recommend keeping the cleanup process intact unless you have a specific reason not to, such as having un-managed assets in
Notes & Considerations
starbase is setup to run with assets referenced via relative paths so generated
.html files can be opened without needing a deployment. If you plan on deploying to a web server, it'll be a good idea to set the
This variable should be set to
/ if the app will run at the root of a domain or subdomain, or to
/folderName (example) if it'll be deployed to a subfolder.
starbase is open source and free software, so you may to do whatever you wish with it -- commercially or personally. You can buy me a beer next time you're in Boston, star the project and tell a friend, or you can erase all signs of origin and tell your coworkers that you made it yourself. It's all good!