Middleman Boilerplate

A simple way to build static pages with a Rails feel.

Using

• Middleman
• Yarn
• webpack with Babel
• Sass

Init a new project

1. Click the green Use this Template button and give your project a name
2. In the new project, click on the green Code button to copy your SSH address
3. cd into the folder named after your Github username in your Terminal
4. Clone the repository like this git clone git@github.com:dmbf29/NAME_OF_YOUR_PROJECT.git
5. Move into the directory cd NAME_OF_YOUR_PROJECT

Installation

Only if you don't have bundler or yarn

gem install bundler
brew install yarn

Then:

gem install middleman
bundle install
yarn install

⚠️ You may run into some into some gem warnings.
Warnings == 👌, but Fatal errors == ⛔️
If you get a fatal error, you can try fixing it with bundle update and hope for the best 🤞

Run a server

• middleman
  or if that fails, try
• bundle exec middleman

Deploy

1. Sign into Netlify
2. Add new site from Git
3. Choose repository and branch
4. Make sure your deploy settings look like this:

5. Website is deployed! 6. (Add purchased domain)

Meta Tags

To use the gem middlman-metaman, follow these setup instructions

Preinstalled

• Bootstrap 4.6 CSS & JS
• Font Awesome CDN
• Webpack

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request