README.md

Stub to start a new BEM project

Project-stub is a template project repository used for BEM projects creation. It contains the minimal configuration files and folders you will need for quick start from scratch.

There are two main BEM libraries are linked here by default:

• bem-core
• bem-components

Just try and taste BEM!

Installation requirements

• Node.js is a platform built on Chrome's JavaScript runtime for easily building fast, scalable network applications.

Installation

So, how easy is it to get started with BEM? Super easy.

It's as easy as...

git clone https://github.com/bem/project-stub.git -b bem-core my-bem-project
cd my-bem-project
npm install

Usage

Now you can run any bem-tools commands from a ./node_modules/bem/bin/bem directory. To be able to run bem-tools commands without typing a full path to an executable file (node_modules/bem/bin/bem), use bem-cli npm package:

npm install -g bem-cli or use an alternative method export PATH=./node_modules/.bin:$PATH

Start the server:

bem server # bem server -p 8080 -v info|silly|debug|verbose|warn|error

hint: execute the above commands in your terminal

Now that bem server is running, check it out:

navigate to: http://localhost:8080/desktop.bundles/index/index.html

Stopping the server is also easy, pressing Ctrl + C while the terminal is your active window will stop the server.

Add block:

bem create -l desktop.blocks -b newBlock

Add page:

bem create -l desktop.bundles -b page

hint: you can add aliases for super easy use

echo "alias 'bemblock'='bem create -l desktop.blocks -b'" >> ~/.bashrc
echo "alias 'bempage'='bem create -l desktop.bundles -b'" >> ~/.bashrc

Generator of BEM projects for Yeoman

This generator provides you the ability to get the base of BEM project in few minutes by answering the simple questions.

• generator-bem-stub

Docs

• Full stack quick start
• Tutorial for BEMJSON template-engine
• Tutorial on BEMHTML
• Tutorial on i-bem.js
• JavaScript for BEM: main terms
• Commands bem-tools

Project-stub based projects

• Creating BEM application on Leaflet and 2GIS API
• Creating a menu of geo objects collections with Yandex.Maps API and BEM
• SSSR (Social Services Search Robot) — study app with BEM full-stack

Useful tools

• bem-cli — run bem-tools locally
• borschik — borschik is a simple but powerful builder for text-based file formats

Videos

• BEM for JavaScript Talk on Camp JS

Working under Windows environment

• bemup-workshop-vagrant — Provisions a clean VirtualBox Ubuntu server instance with all needed Node.js development tools