Skip to content

Latest commit

 

History

History
51 lines (38 loc) · 2.54 KB

File metadata and controls

51 lines (38 loc) · 2.54 KB

webpack-tailwindcss

This template is made to help start your project based on Webpack + TailwindCSS. Setup is pretty simple, while keeping best performance practices set up.

Usage

  1. To use this template, click "Use this template" green button in the top right.
  2. Clone the repository to your computer
  3. Install dependencies - npm ci
  4. Configure where your views are in tailwind.config.js.

npm tasks

  • npm start - runs dev server on http://localhost:8080 and reloads the browser on changes
  • npm run build - build assets in production mode, ready to deploy

Webpack setup includes

  • JS and CSS transpilation and minification done by ESBuild (FAST)
  • CSS extraction using mini-css-extract-plugin
  • HTML generation using html-webpack-plugin
  • Example of:
    • Prefetched chunk, if you want to load faster critical parts of your build
    • Asynchronously loaded chunks, to block page rendering when loading/parsing/executing
    • Named chunks if you dont want your chunks to look like 2aae6c35c94fcfb415dbe95f408b9ce91ee846ed.js

PostCSS setup includes

  • autoprefixer - Adding vendor prefixes, just in case. See package.json for browserslist config
  • postcss-import - Support for @imports - just like in SASS

TailwindCSS setup includes

  • Official TailwindCSS forms plugin loaded
  • How to extend default color palette
  • How to set a different font as first in font family declaration
  • xxl breakpoint for responsive purposes

Notes

  • Before every build, build directory is deleted to avoid deploying old assets

Additional resources

Happy coding!

TODO

  • Investigate webpack-dev-server npm audit issues
  • Create github pages preview
  • Write simple codeceptjs test run on the example, after the deployment