canonical /vanilla-framework
From community websites to web applications, this CSS framework will help you achieve a consistent look and feel.
★ 993⑂ 224👁 31⑃ 3,086● 2,709▤ 217
+0
Daily
993
stars
224
forks
31
watchers
3,086
prs
2,709
issues
217
releases
README
!vanilla Vanilla Framework Vanilla Framework is an extensible CSS framework, built using Sass and is designed to be used either directly or by using themes to extend or supplement its patterns. Documentation | Table of contents - Using Vanilla - Hotlinking - Including Vanilla in your project via NPM - Developing Vanilla - Community Using Vanilla Hotlinking You can link to the latest build to add directly into your markup like so, by replacing the x values with the version number you wish to link. html Including Vanilla in your project via NPM or yarn To get set up with Sass, add the sass and vanilla-framework packages to your project dependencies: bash yarn add sass vanilla-framework In the script that builds the CSS in your package.json, you should include the path to node_modules when looking for @imports. In this example, we have called the build script "build-css": "build-css": "sass -w --load-path=node_modules src:dist --style=compressed" Make a folder src/, create a file inside called style.scss and import Vanilla: sass // Import the theme @import 'vanilla-framework'; @include vanilla; // Optionally override some settings $color-brand: ffffff; // Add theme if applicable If you don't want the whole framework, you can just @include specific parts - e.g. @include vf-b-forms. Now run yarn build-css, which will convert any Sass files in the src/ folder to CSS in the dist/ folder. To watch for changes in your Sass files, add the following script to your package.json "watch-css": "yarn build-css && sass --load-path=node_modules -w src:dist --style=compressed" Developing Vanilla If you're looking to contribute to the Vanilla project itself, start here. - Code of conduct - Reporting bugs and issues - Working with the Vanilla project - Pull requests - Releasing Vanilla Community Keep up to date with all new developments and upcoming changes with Vanilla. - Read our latest blog posts at Ubuntu Blog - Stay in touch with us on Matrix Code licensed LGPLv3 by Canonical Ltd With ♥ from Canonical
Top issues
#3758Active stepped-list state17 comments · 2021-05-24#5635[Component amendment]: Merge or Deprecate Logo Section component in favor of Logo Section Pattern14 comments · 2025-09-02#4704Improvements to pagination14 comments · 2023-03-17#5447[New component]: Date picker13 comments · 2025-01-22#4633Add new dark link option and improve inverted link accessibility documentation12 comments · 2023-01-26#4494Floating Notifications 11 comments · 2022-06-17#4100Create example of a grouped table row11 comments · 2021-10-27#5494Make non-semantic icon color context-sensitive10 comments · 2025-04-02
Latest release
v4.61.0 v4.61.0 2026-10-16What's Changed fix: add requests to requirements and pin flask by @Skazitron in https://github.com/canonical/vanilla-framework/pull/5854 fix: padding/layout update by @Skazitron in https://github.com/canonical/vanilla-framework/pull/5848 feat: add dark theme option to content card by @Skazitron in https://github.com/canonical/vanilla-framework/pull/5855 fix: update deploy job permissions for contents and packages by @Ataku-B in https://github.com/canonical/vanilla-framework/pull/5858 New Contributors @Ataku-B made their first contribution in https://github.com/canonical/vanilla-f