KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #claude-code #mcp #rust #deepseek-harness #ai-agent #cli

Simple-Boilerplate

★ 65 Open GitHub ↗

A simple frontend boilerplate to build professional web projects easily and quickly.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ![Simple Boilerplate](https://raw.githubusercontent.com/mjnr/Simple-Boilerplate/refactor/dev/images/logo.jpg)
[![Build Status](https://travis-ci.org/mjnr/Simple-Boilerplate.svg?branch=master)](https://travis-ci.org/mjnr/Simple-Boilerplate)
[![devDependency Status](https://david-dm.org/mjnr/Simple-Boilerplate/dev-status.svg)](https://david-dm.org/mjnr/Simple-Boilerplate#info=devDependencies)
[![Dependency Status](https://david-dm.org/mjnr/Simple-Boilerplate.svg)](https://david-dm.org/mjnr/Simple-Boilerplate)
[![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)]()

A frontend boilerplate to build professional web projects easily and quickly.

## Features
- [NPM Scripts](https://docs.npmjs.com/misc/scripts) - Build Scripts.
- [Browsersync](http://www.browsersync.io/) - Watch project changes and updates browsers.
- [Pug](http://jade-lang.com/) - Template Engine.
- [Critical](https://github.com/addyosmani/critical) - Add inline critical path css to html pages.
- [Stylus](http://stylus-lang.com/) - Preprocessor.
- [Rucksack](https://simplaio.github.io/rucksack/) - Postcss Features.
- [Jeet](http://jeet.gs/) - Grid System.
- [Rupture](http://jenius.github.io/rupture/) - Media Queries.
- [Webpack](https://webpack.github.io/) - Module Bundler.

## Instalation

You will need to install [NodeJS](http://nodejs.org/).

```sh
# Clone the repository.
$ git clone https://github.com/mjnr/Simple-Boilerplate.git project
$ cd project

# Installs all the dependencies and starts a mini server on port 3000.
$ npm install && npm start
```

## Folder Structure
Basically the development files are in the **dev** folder and compiled files go directly to **dist**.
```
dev
├── images
│   └── logo.png
├── scripts
│   ├── main.js
│   └── modules
│       └── my-module.js
├── styles
│   ├── base
│   │   ├── base.styl
│   │   ├── fonts.styl
│   │   └── helpers.styl
│   ├── components
│   │   └── my-component.styl
│   ├── config
│   │   ├── aliases.styl
│   │   ├── functions.styl
│   │   ├── mediaqueries.styl
│   │   └── variables.styl
│   ├── layouts
│   │   └── container.styl
│   ├── main.styl
│   └── vendors
│       └── normalize.styl
└── views
    ├── includes
    │   ├── analytics.pug
    │   ├── metatags.pug
    │   ├── scripts.pug
    │   └── styles.pug
    ├── layouts
    │   └── default.pug
    └── pages
        └── index.pug
```

## Views
The view structure is based on Pug Template Engine features and it generate .html files. See more [here](http://jade-lang.com/reference/).

#### Data file
**[options.json]("./options.json")**
```json
{
	"sitename": "Simple Boilerplate",
	"basedir": "./dev/views/",
	"root": "/",
	"analyticsCode": "UA-XXXXX-X",
	"pages": {
		"home": {
			"title": "Simple Boilerplate - Just a simple frontend boilerplate",
			"description": "A simple frontend boilerplate to build professional web projects easily and quickly.",
			"keywords": "boilerplate, node, frontend, pug, stylus, webpack"
		}
	}
}
```
#### Default Layout
Its possible [extends](http://jade-lang.com/reference/extends/) the default [layout]("dev/views/layouts/default.pug") to create pages.
```jade
block vars
	- var page;

doctype html
html(lang="en")
	head
		title #{pages[page].title}
		meta(charset="UTF-8")
		meta(http-equiv="X-UA-Compatible" content="IE=edge")
		meta(name="viewport" content="width=device-width, initial-scale=1.0")
		
		block metatags
			include /includes/metatags

block styles
			include /includes/styles
	body
		main.main
			.container
				block content

block scripts
			include /includes/scripts

block analytics
			include /includes/analytics

```

#### Page
```jade
extends /layouts/default

block vars
	- var page = "home"

block content
	section.content-section
		h1.title
			| Simple Boilerplate

```

## Styles
The style structure is a blend of several CSS architecture concepts, with emphasis on [SMACSS](https://smacss.com/book) and [RSCSS](http://rscss.io/) . Currently, it is divided into:

```stylus
/*
* Simple Boilerplate
* https://github.com/mjnr/Simple-Boilerplate
* -----------------------------------
* Author: Milson Júnior
* URL: https://github.com/mjnr
* -----------------------------------
* Project Name
* -----------------------------------
*/

// Config
// -------------------------
@require 'config/*';

// Vendors
// -------------------------
@require 'vendors/*';

// Base
// -------------------------
@require 'base/*';

// Grid System
// -------------------------
@require 'jeet';

// Components
// -------------------------
@require 'components/*';

// Layouts
// -------------------------
@require 'layouts/*';
```

## Scripts
It is currently possible to create multiple bundles with Webpack and write modules using ES6 features.

#### Module
```javascript
export default function() {
	console.log('Simple Boilerplate is working!');
}
```

#### Bundle
```javascript
import myModule from './modules/my-module.js';

myModule();
```

## Available tasks
- `npm start` Start watch for changes and server with Browsersync.
- `npm run build:dev` Run all dev tasks
- `npm run build:prod` Run all dev tasks and minify all files for production.
- `npm run lint` Lints styles and scripts.

Simple-Boilerplate

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README