A Parcel boilerplate to automatically deploy on Github Pages using Github Actions.
Demonstration website deployed here.
- Parcel: The zero configuration web application bundler
- Babel: The Javascript compiler. It's used implicitly by Parcel. Already contains a configuration for React.
- Sass: The CSS pre-compiler.
- Bootstrap 4: The CSS framework, its SCSS files are compiled by Parcel which allows to override the theme. (The provided theme is Cerulean from Bootswatch.)
- Eslint with the standard configuration: Because everyone should use a linter nowadays.
- Nunjucks: The best Javascript template engine available. Useful to have multiple different pages on your website.
- Font Awesome: Everyone needs icons right ? The provided version does not use a CDN, they are automatically bundled during the build.
- Fork this repository and publish it in a new Github repository.
- Go in the settings of your repository and under
Github Pagesconfirm that you want your Github Pages website to be built from thegh-pagesbranch. The settings page should then indicate you the URL of your deployed website, which should behttps://<your github account>.github.io/<the repository name>/in most cases. - Change something in your website to trigger a build and deployment (as example changing the text in
index.njk).
Any following push to the master branch will automatically trigger the Github Actions workflow that will build and deploy your website to Github Pages.
To install the requirements:
npm install
To start the project in development mode (automatically re-compiles the code):
npm start
To check the code with eslint (the CI will fail if this step doesn't pass):
npm run lint
To automatically fix the lint problems:
npm run lint:fix
I'm a fan of Github Pages for the possibilities it offers to anyone to publish a website for free. I have multiple projects that could be of interest if that's your case too:
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}