Neo public pages is a Jekyll boilerplate template that uses Bootstrap 4 and SASS to generate static websites.
What is Neo public pages?
Neo public pages is a Jekyll boilerplate (a starter project) whose repository description identifies it as "Bootstrap 4 SASS with Jekyll." It runs on the Jekyll static site generator, which processes Markdown and Liquid templates into plain HTML, CSS, and JavaScript. The project is managed with Bundler, so it expects Ruby and RubyGems on the system. The template's core function is to save setup time by shipping a working Jekyll configuration with Bootstrap 4 and SASS already wired in.
Key Features
- Jekyll boilerplate — A ready-to-run Jekyll project structure, ideal for static sites and blogs.
- Bootstrap 4 integration — Bootstrap 4's grid system, components, and utilities are included for responsive layout.
- SASS styling — Styles are written in SASS, allowing nesting, variables, mixins, and other preprocessor features.
- Bundler support — A Gemfile manages dependencies; the README instructs installing Bundler and running
bundleto install gems. - Split configuration — Includes both
_config.ymland_config_dev.yml, with a serve command that loads both files so development settings can override production defaults. - Local development server — The provided
jekyll servecommand builds the site and serves it locally for preview.
Who is it for?
- Jekyll developers — who want a working Bootstrap 4 and SASS setup without manually configuring the asset pipeline.
- Front-end designers — who prefer to customize styles using SASS variables and Bootstrap's theming system.
- Rapid prototypers — who need to spin up a static site quickly and need a solid foundation to build on.
How does Neo public pages work?
The build environment is straightforward. First, install Bundler with gem install bundler, then run bundle (or bundle install) to install the gems defined in the Gemfile. To serve the site locally during development, run jekyll serve --config _config.yml,_config_dev.yml, which merges the main configuration with a development-specific configuration file. The generated site is output as static files that can be deployed to any web server.
FAQ
How do I install the dependencies for Neo public pages?
Run gem install bundler to install Bundler, then run bundle (or bundle install) in the project directory to install the gems specified in the Gemfile. Ruby and RubyGems must already be installed on your system.
How do I serve the site locally?
Use the command jekyll serve --config _config.yml,_config_dev.yml to start a local development server. This builds the site and serves it at the default localhost address used by Jekyll.
Why are there two configuration files?
The serve command loads _config.yml and _config_dev.yml together, allowing development-specific settings to be layered on top of the base configuration. This is useful for overriding URLs, enabling debugging, or adjusting build options during development.
