BEM projectMinimal setup to start a new
This repository contains the minimal configuration-files and folders you will need to create a BEM project from scratch.
So, how easy is it to get started with BEM? Super easy.
It's as easy as...
git clone git://github.com/bem/project-stub.git
(hint: execute the above commands in your terminal)
bem server is running, check it out:
Navigate to: http://localhost:8080/desktop.bundles/index/index.html
(here, have a link: http://localhost:8080/desktop.bundles/index/index.html)
That's it, it's that simple. Congratulations, your BEM project is already underway!
Was that too easy?
Here's the replay... that
make command will:
- Install a local copy of all required dependencies from npm into the
./node_modulesdirectory. (specifically: bem-tools)
- Start a local
bem serveron port
What do we mean by "a local copy of all required dependencies"?
Well, when you run the
make command for the first time, we install all of the required dependencies (bem-tools)
./node_modules directory within the local project directory. This is not the same thing as
installing bem-tools locally to your environment - which, if you haven't
done already, we strongly suggest that you do. This is by far the easiest, quickest way to use
bem-tools in a more beautiful way.
Start the Server:
Each subsiquent time you wish to start the server you may simply run the
make command in your terminal.
Alternatively you may opt to use the following command:
› ./node_modules/.bin/bem server
This is the ugly way to run the
bem server command. If you think it's ugly too and wish for a better way keep reading...
An Easier, More Beautiful Way:
Once you have either (a) fixed your PATH environment variable, or (b)
properly installed bem-tools to your local environment.
You may now, more elegantly, start your
bem server by running:
› bem server
Stopping the Server:
Stopping the server is also easy:
[ctrl] + [c]
[ctrl] + [c] while the terminal is your active window will stop the server.
Fix your PATH environment variable:
For a more permanent way to "easily" use the local-to-this-project's installation of
bem-tools all you must do is ensure that the path to the
./node_modules/.bin) is included in your
PATH environment variable.
> export PATH=./node_modules/.bin:$PATH
Optionally you may also add
export PATH=PATH_TO_PROJECT_DIRECTORY/node_modules/.bin:$PATH to your
PATH_TO_PROJECT_DIRECTORY with the actual path to your project)
For more information about the BEM metodology check out http://bem.info.