openproject/frontend/doc/README.md

# Developing OpenProject Frontend

## Development server

To start the development server:

    gulp dev

## Living Style Guide

The style guide is available at: <http://localhost:8080/assets/css/styleguide.html>.

## Changing or updating Dependencies

We use `npm shrinkwrap` to lock down runtime (but not development)
dependencies. When adding or removing dependencies, please adhere to the
following workflow:

    npm install
    npm shrinkwrap
    ./scripts/clean-shrinkwrap.js

Please commit `npm-shrinkwrap.json` along with any changes to `package.json`.

## Topics

The individual topic for the documentation fo the frontend are

- OVERVIEW.md - a general overview on the folder structure and a general "what is where"
- TESTING.md - documentation of our approach to integration and unit testing
- STYLING.md - notes on styling and the Sass-Pipeline
- RAILS.md - an overview for the frontend parts still left in the Rails stack (mostly the JavaScript