ui-guide
Code for creating frontend user interfaces.
Usage
Currently this code is not ready on its own. We need to do more work to fully build out all the parts we need to build our interfaces.
Each of the pages found at the documentation site should show how and when to use various parts of the ui-guide.
Development
Prerequisites
Setup
In order to develop within the ui-guide you'll need to run the below commands. They install then node dependencies as well as the needed libraries to run jekyll.
npm install
grunt setup
Running
After you're initially setup all you need to have two windows open to run the site and get updates:
grunt monitor
jekyll serve
This does a few things:
- Runs the jekyll site
- Updates the output CSS as you work
- Updates the pages so you do not need to restart the server
The local site can be see at http://localhost:4000/ui-guide.
Code Style
The current guide used for code development:
- Follow BEM for CSS naming
- less variables do not follow BEM, they are not CSS
- Naming should allows be
block
=>element
=>modifier
(e.g.person__hand--left-hand
)
- The
index.less
file combines all less files together - The
mixins
directory is only for true mixins - Follow the http://cssguidelin.es/ when writing code, see existing code for examples
- Always add at least one example of your change to the example pages
- Make your contribution work for RTL styles
TODO
Overall project things to do are in a gist that can be found here:
https://gist.github.com/garrypolley/5c8d29df98cd3c1261cd
Things to cleanup as this project grows:
- Add consumer docs for existing parts
- Grid
#site-container
- Add developer docs (code docs may be good enough when used with the consumer docs)
- Add sub navigation for pages like typography and colors
- Automate the
gh-pages
bits when making the development site legit