Skeleton

Jump-start your front-end development. Skeleton is a HTML5 Boilerplate build upon Rosid.

Contents

• Features
• Requirements
• Setup
• How to use
  • Develop
  • Compile
• Troubleshooting

Features

• Skeleton is a base for all your everyday web-projects. Jump-start your work and develop without starting from zero. Everything you need one fork away.
• This project is powered by Rosid, a web server with just-in-time pre-processing. JS (with Babel, UglifyJS), SASS (with cssnano, Autoprefixer) and EJS can be used right out of the box.
• Skeleton is just the beginning. Fork it and extend it to your own needs. The predefined structure gives you flexibility and can be modified with ease.

Requirements

Skeleton dependents on …

• Node.js (v6.2.0 or newer)
• npm
• Bower

Make sure to install and update all dependencies before you fork and setup Skeleton.

Setup

Install all required dependencies from both npm and Bower before you start developing. All steps are combined into one single command, which can be executed when both package managers are installed on your system.

npm install

How to use

Develop

Start developing using the following command. You browser will open, wait for code-changes and live-reload instantly when you update your files. JS, SASS and EJS will be compiled on-the-fly.

npm start

Compile

Ready for prime time? Export all files, compiled and prepared for your audience. Simple upload the final dist/ folder to your server and relax. Take a seat and enjoy a delicious burger from your favorite restaurant.

npm run compile

Docker

The included Dockerfile lets you build an image which compiles your site. In this case only Docker needs to be installed on the system. No other dependencies are required.

Build

Build an image from the Dockerfile. This has to be done each time you have modified the project. The new source will be copied into the image.

docker build -t electerious/skeleton .

Compile

Start a container to compile your site. The container will exit automatically when all tasks have been finished. The mounted volume will contain all compiled files.

docker run --rm -tv $(pwd)/dist:/dist electerious/skeleton

Troubleshooting

• Install the latest version of Node.js and npm
• Delete node_modules and src/assets/bower and reinstall all dependencies
• Check if the project depends on the newest version of Rosid
• Try to compile the site using the included Dockerfile
• Fix your npm permissions when receiving an EACCES error