Manifesto

Vanilla is an open source framework developed and continually evolved by Canonical to promote consistency, enable code reusability and improve performance across the full portfolio of Canonical sites.

These are the guiding principles;

• Vanilla Framework (VF) is a living CSS framework, written in Sass. It should adapt and evolve and we should always seek to improve it where possible.

• VF is developed using progressive enhancement, starting with smaller screens first, then scaling up.

• We view performance as a feature. This means we care about the size of the framework as a dependency and the performance of the resulting CSS.

• VF should only contain styles likely to be used across a wide range of sites in the Canonical portfolio.

• Any styles specific to a select group of sites can be abstracted to a theme layer which will inherit VF as a dependency.

• Any styles specific to one particular site should be added to that site codebase alone.

• If similar styling has been used separately across two or more sites, a pattern should be abstracted and that styling should be moved upstream.

• Code should only be merged when it follows agreed conventions as enforced by linting.