--- title: Developing for Vanilla v1 description: As Inayaili recently blogged, we are now working towards a goal of releasing Version one (v1) of Vanilla for early September. Maturity Vanilla was created just over a year ago and in that time has been used to build a wide range of sites across Canonical and beyond. It currently averages around 1,500 downloads a […] url: https://canonical.com/blog/developing-for-vanilla-v1?format=md --- 1. [Blog](https://canonical.com/blog) 2. Article --- [Barry McGee](https://canonical.com/blog/author/barry-mcgee "More about Barry McGee") 29 July 2016 # Developing for Vanilla v1 [Design](https://canonical.com/blog/tag/design) --- Share the article As [Inayaili](https://plus.google.com/u/0/101183690676202208159?prsrc=4) recently blogged, we are now working towards a goal of releasing Version one (v1) of Vanilla for early September. #### **Maturity** Vanilla was created [just over a year ago](https://design.canonical.com/2015/06/introducing-vanilla/) and in that time has been used to build a wide range of sites across Canonical and beyond. It currently averages [around 1,500 downloads a month](https://www.npmjs.com/package/vanilla-framework) on NPM. We’ve been delighted to see it grow in popularity and see the myriad of different experiences people have been building using Vanilla. A big advantage of this wide adoption is the feedback we’ve received from developers on the front line, including within our own teams at Canonical. This feedback has enabled us to identify growing pains and mark out clear areas for improvement. The overarching themes for v1 are maturity and stability — ensuring the framework is a cohesive set of building blocks and also making sure those building blocks are stress tested and robust. #### **Practical steps** The first step we will be taking is to audit the codebase and ensure it adheres to our coding standards. This will include encapsulating all components with the [BEM methodology](https://en.bem.info/methodology/) which we have introduced to our coding standards within the last year. We will also be working to improve accessibility and responsiveness of each component while making some aspects of the codebase less opinionated to help increase its applicability to a broad range of use cases. Another big area earmarked for love is the documentation provided for Vanilla. Given that the framework is now used by a wide and diverse set of people, we can make no assumptions about what they may know. So we need to provide comprehensive documentation that not only details how to implement each component but that also explains where each component should or should not be used. It’s also important that everything in Vanilla is visible. Over time, code has slipped into Vanilla that is not documented on the [demo](http://ubuntudesign.github.io/vanilla-framework/demo/).  This can cause page elements to display in ways a developer might not expect. We will be addressing this by building a comprehensive documentation site at a dedicated URL. This will be the one-stop-shop for all things Vanilla and will replace the current Vanilla demo page and Sass docs. We will also be restructuring Vanilla so it is in a better place for scalability and extensibility going forward. Vanilla currently employs a flat structure for simplicity but we’ve come to realise that it can be confusing to mix components with utilities and presentation with configuration. We recently had a team discussion on possible ways to structure the code within Vanilla and settled on an approach minted by [Harry Roberts](http://csswizardry.com/) — Inverted Triangle CSS or [ITCSS](https://speakerdeck.com/dafed/managing-css-projects-with-itcss). Structuring Vanilla in this way will not only improve the quality of the resulting CSS but make it much easier to initiate new developers to building with Vanilla. *Layers of ITCSS – courtesy of Harry Roberts* #### **Exciting times** I’m very excited about this project and think it has huge potential to help shape how we in Canonical approach building experiences on the web, not to mention how the wider community will benefit from these changes. If you have any feedback or ideas on the future direction of Vanilla from a development point of view, please do comment below – we’d love to hear from you. [Get in touch Interested in running Ubuntu in your organization?](https://ubuntu.com/about/contact-us/form) ## Sign up for our newsletter Get the latest Canonical news and updates in your inbox. Work email: \*I agree to receive information about Canonical's products and services. By submitting this form, I confirm that I have read and agree to [Canonical's Privacy Policy](https://canonical.com/legal/dataprivacy). Sign up ## Share on --- ## Related posts [### Challenges designers face in open source (and how to fix them)](https://canonical.com/blog/challenges-designers-face-in-open-source-and-how-to-fix-them) Open source powers up to 90% of modern software, yet many projects lack usability. Canonical’s Design team surveyed 115 cross-functional professionals to uncover the 4 core... [Kola Ojoodide](https://canonical.com/blog/author/kola-ojoodide) 26 June 2026 [### Why web engineering is great](https://canonical.com/blog/why-web-engineering-is-great) Hi, I’m Johann! I’m an engineering manager in Canonical’s web team. For the larger part of my 15 years of work experience as engineer, I’ve been working in web development.... [Johann Wolf](https://canonical.com/blog/author/johannwolf) 27 April 2026 [### Canonical’s recipe for High Performance Computing](https://canonical.com/blog/canonicals-recipe-for-high-performance-computing) In essence, High Performance Computing (HPC) is quite simple. Speed and scale. In practice, the concept is quite complex and hard to achieve. It is not dissimilar to what... [Igor Ljubuncic](https://canonical.com/blog/author/igorljubuncic) 24 January 2024 [### Web team – hack week 2023](https://canonical.com/blog/web-team-hack-week-2023) Today, around 96% of software projects utilize open source in some way. The web team here at Canonical is passionate about Open source. We lead with an open-by-default approach... [Anthony Dillon](https://canonical.com/blog/author/ya-bo-ng) 25 October 2023