Our Marketing Blog

Our industry is ever-changing. Get insights and perspective from our experts as we share our knowledge and experience on how to successfully navigate the marketing landscape.

CREATING USEFUL STYLE GUIDES FOR WEB PROJECTS - PART 2

In part two of two, we'll explore different ways to create styleguides and what works and doesn't about each method. Throughout, we'll look at examples. If you haven't read the first part of this series from last month, or need a refresher, click here.

We have already defined what a styleguide is, and what types of visual definitions need to be in them - and I've made recommendations about when to create them. This post will dive into the different ways of actually creating the styleguide.

Method One: Static Old School

I'm calling this the Static Old School method: A designer or production artist lays out a styleguide based on the design system for the project in Illustrator or Photoshop. They export it as a PDF, get client approval, and move on to layout. The PDF is handed off to the developers to begin their baseline work.

Pros:

  • Gets the job done
  • Gives designer complete control over formatting and layout, which may be useful for client presentations

Cons:

  • Not easily updated - requires a designer to maintain
  • Does not keep designers honest - a label indicates that this blue color is #3c89bf — but is it actually?
  • Not interactive - cannot demonstrate rollover states or add code snippets
  • Developers cannot easily highlight text to inspect additional properties that may not be defined, such as line height

Verdict and Recommendation:

On a small project or one with a short timeline, this approach will suffice. There are enough "cons" to avoid it if you can though.

Method Two: Use a Plugin!

Since a designer has her layout in a design program like Photoshop or Sketch already, wouldn't it be really convenient if a magic button could be pressed and a styleguide is automatically created? Fear not, this magic button exists.

The most well-known style guide generator is Craft by Invision. Invision is an online collaborative prototyping tool that allows designers to upload their layouts, request reviews or comments from other team members or clients, and simulate interaction by creating clickable hotspots.

If a layout is uploaded correctly, developers can interact directly with the app to inspect fonts, measurements, and CSS properties:

Invision has created a plugin called Craft that allows designers to automatically generate a styleguide based on all of the existing properties in their layout. The plugin will analyze all of the font properties and colors used in your various page layouts and generate a separate static styleguide for you. This can then be exported as a PDF / static styleguide and shared, or uploaded to Invision for review and for developer inspection.

I created a demo of the plugin in action which you can view below:

https://youtu.be/BzENA_cibds

https://www.youtube.com/watch?v=BzENA_cibds

Craft is not the only game in town - zeroheight uses a Sketch or Photoshop plugin to generate a styleguide based on a layout as well. There are additional steps and control given to this tool, since zeroheight lets you create products with technical specs as parameters (such as the design and screen resolution). In this way, this solution is a combination of a local design plugin and an online management tool.

Unlike Craft, the designer has more control about what ends up in the layout to begin with - avoiding the scenario where every single color or font on the layout ends up in the styleguide that later has to be removed. Zeroheight will also allow designers to define entire component definitions, which make for a much more robust styleguide.

Once the designer defines the parameters and what layers should be included, zeroheight will export the generated guide to its server, where the interactive styleguide is automatically created based on the export. This is where your living styleguide is put for further editing, viewing and sharing with other team members. Unlike Craft, where the generated styleguide is just another page in your layout, the zeroheight styleguide is managed within its website.

A risk I see with this approach is if a design changes but the styleguide is not synced, there's no guarantee a developer is seeing the latest changes. Deciding on a proper workflow can help mitigate that risk.

zeroheight has other bells & whistles, such as JIRA and Slack integration, that can notify team members when the styleguide defintion is updated.

It's unclear how much this service costs, but since it's more than just a plugin, I am guessing there is a subscription model involved. The website provides no pricing model, no demo (I found a few on YouTube) and no trial version, so you don't really know what you're getting without having to go through a sales call and presentation. Likely, the people making the decision to purchase the product aren't the people who are sussing out whether the tool works for them or not, which can require a lot of legwork for the team just to find out whether the tool is going to do what they want or not.

Pros:

  • Reduces the amount of work required by designers to create the styleguide
  • May help keep designers honest - in the Craft demo video above, you can see I had multiple similar shades of grey and orange that were not intended. In a real-world example, I'd need to decide whether those colors are still required, or remove them from my layout.
  • Removes any ambiguity in the definitions - yes, that really is 60pt font, and yes that really is #3c89bf
  • Excellent Sketch support
  • Can be easily re-exported as your design changes to capture more definitions

Cons:

  • Requires the layout to be defined first
  • While it may keep designers honest, they may not go back to actually address duplicates or ambiguous definitions in their primary layout, leading to more ambiguity.
  • Outputted result is still static unless you use Invision or zeroheight, which is not free
  • Not sure if it works as well for Photoshop, unknown whether it exists for other layout tools at all.
  • No way to make Craft interactive
  • Craft only captures colors and fonts; doesn't capture button styles or any additional design language components that should be in a complete styleguide (zeroheight is more comprehensive)

Verdict and Recommendation:

This is better than doing it entirely by hand if you're using Sketch (and even moreso if your team is using Invision anyway), but the output result of Craft is not enough to be considered a complete styleguide, and there's no real way to make it interactive.

zeroheight shows more promise, but without the ability to try the product out, you have to hope that that it does everything I think it does. I can't make a strong recommendation for or against it at this point without knowing more or having some hands-on time with it.

Method Three: Generators Upon Generators!

David Hund was kind enough to compile an enormous list of code-driven generators, of which ... there are many:

Without the luxury of going through each individual tool and testing it out, these are very cool for a few reasons - they can live in your existing code projects which means you are not creating these based on the prototype layout, but actually basing it on production code. The end result is an interactive styleguide based on code you've already written. Some of the tools will automatically generate the styleguide, meaning you can continue writing the code for your project and the styleguide gets continuously updated; others require more input from the developer.

A few examples and demos for some selected items are below:

  • Stylemark, which will generate a nice page for you based on markdown format;
  • Patternlab
  • React Styleguidist
  • KSS, which generates a styleguide based on /* comments */ developers put into their CSS and HTML templates. The comments are parsed by the tool, which outputs a HTML file with visuals and code snippets.
  • Storybook.js, a UI development environment for JS projects (React, Vue Angular)

Many of these tools have the same or similar functionality as their counterparts, and many of them won't apply to your specific project based on the platform it is living on. That said, there are many to choose from for a variety of platforms - and additional research and trial & error is likely the only way to find the one with the right feature set for you.

While these are pretty slick and ultimately devs like me are easily impressed by any tool that "automagically" does something, the big unspoken issue here to me is that these tools cut out the designer from the process, and developers don't just make up the styles from scratch in the development phase. Thus, these tools are not a replacement for a styleguide, since a designer is going to need something to even start the project - they are likely going to *still* need the designer to hand something off statically at the start.

So, that means these tools are likely a way to convert the styleguide from its initial form to a living form - but are not a replacement or the only styleguide to be created on the project.

Pros:

  • Reduces the amount of work required by developers to create an interactive styleguide
  • Can be integrated with source control so there's never a disparity between the core site code and the generated styleguide
  • Generates something that can be pushed to a public (or protected) URL and visited / referred to easily - eliminating the "Which is the the latest styleguide PDF?" question
  • Since the styleguides are based on existing code, what is in them accurately represents the current state of the project.
  • Can be continuously updated to reflect the latest styles and code

Cons:

  • An overwhelming number of choices
  • A lot of these options are open-source and/or undermaintained - meaning no support if something doesn't work
  • Ability to implement may require developer resources and hours that aren't available
  • The tool you like may not be compatible with your framework or project platform
  • Learning curve range depending on which tool is used and how involved it is.
  • Often dependent upon learning and installing additional technology (various node packages, third-party dependencies, etc)
  • Totally cuts out the designers from the process, unless they are also writing the code.
  • Since the styleguides are based on existing code, what is in them may not *accurately* represent what the design was *supposed* to be!

Verdict and Recommendation:

Smashing Magazine has a nice, more in-depth review of some of these tools - though it's a few years old - worth checking out if you are compelled to move in the generator direction.

Other Web Applications

We've already briefly talked about Invision, which is more of an online prototyping tool. It becomes more than just that when using the Craft plugin. However, there are also online services tailored specifically for generating styleguides, for a fee. Two additional examples are Frontify and Patternry; zeroheight would also fit into this category as outlined above.

FRONTIFY

The approach for Frontify is to allow users to upload or add specifications via WYSIWYG editor. This could be done before, during, or after high-fidelity design by a designer, and can easily be updated as code snippets become available by the developer. It appears to allow for a collaborative approach that could be integrated at various points along the phase of a project.

Frontify Style Guide from Frontify on Vimeo.

Frontify offers additional services, such as a media library for storing image assets, and what they call a Brand Portal, for entire brand identity suite. The product aims to be a central repository for any given brand or product's guidelines, to be shared by designers, marketers, and developers alike.

PATTERNRY

If Frontify is trying to be everything to everyone, Patternry narrows its range of services and its target user. In Patternry, building a style guide requires a developer to write code that is hosted within Patternry. The target user for this product is a UI designer / developer - the product does not run off of drag-and-drop or WYWIWYG tools. The end result is more control.

The component definitions inside Patternry seem to depend upon production-ready CSS and JS to function, introducing some concern about keeping code in sync between your code repository and Patternry. This also limits the collaboration aspect, as a designer without code experience can't dive in to make adjustments.

Verdict and Recommendation:

It's clear that these types of services wish to make the creation of sharable and maintainable style guides quite easy, but also wants to hitch users into a subscription model where they are dependent upon them as part of their workflow. That may not be in your budget, and may be yet another thing to track (along with GitHub, JIRA, Basecamp, etc).

Some of the features are fairly robust, though, and the idea of not having to create any code from scratch is appealing. The feature set of Frontify seems pretty broad, so if your team can define a workflow that works for everyone, it may be a very useful suite of tools that act as a central repository for your style guides and brand standards. With Patternry, it seems to be more of a framework for an online styleguide than an actual generator or creator. That may be okay, but keep in mind that it's likely going to introduce code disparity between your repository and styleguide. Using a code-based generator tool as described above may be more useful.

Some More Online Styleguide Examples

FRONTIFY

Frontify - covered above - used their own tool to generate their styleguide. Always nice to see a company pracitcing what they preach and using their own tools. I like how it mixes both visual definitions, when to use what, and provides code samples. They also categorize the sections into Design, Identity and Communication. Very thorough, but goes beyond a styleguide for a website and into the brand identity / pattern library for the entire product. View it here.

Frontify ColorsFrontify Typography


YELP

Yelp provides its styleguide online publically, which provides nice code-toggle ability. The visual layout of the styleguide is less engaging than the previous example, which is perhaps emphasises the utilitarian nature of it. View it here.

Yelp IslandsYelp Color - including SASS variablesYelp Typography - Including utility class definintions for front-end developers or content editors


PAGEUP PEOPLE

This is a styleguide that clearly took a lot of time to build. I like how this styleguide includes code samples for each component along with usage notes to remind authors how to utilize each component. I think their foundation area could use some more baseline code samples (typography, for example) but it possible that is baked into their global stylesheet, and developers would not have to touch it. View it here.

PageUp color - nicely designed color blobs, though users have to hover above them to view the hex value.PageUp Buttons - Very thorough with helpful do's and don'ts and code samples.PageUp Component example - includes code sample and usage guidePageUp Typography - This section looks nice but is lacking for more detail around the values (line spacing / letter spacing, weights, etc)

More examples:

  • via CreativeBloq — Three Online Style Guides That Do It Right
  • via Hubspot — Apple, Google & Starbucks: Inside the Web Design Style Guides of 10 Famous Companies

Conclusion

The takeaways here are that there will not likely be a single tool for solving the styleguide portion of the project. Nor should the responsibility of creating styleguide be assigned to only the designer or developer — it should be a collaborative process between technology and creative. We have found out that in some cases, two styleguides will need to be created - one static, perhaps for client approval and tech handoff; and one dynamic / interactive that will be the evergreen and living document to be referenced.

It's also clear that everyone has their own definition of the right order of operations for creating styleguides. In my previous post, I had recommended starting with the styleguide, but also recognize that this workflow is not possible for everyone or for every project. Some of the tools outlined above will be more flexibile than others to fit your approval process and work style.

I would suggest that an important criteria for selection is the ability for the tool or methodology to be flexible enough to work with you, rather than one that forces you to change your workflow in order to use. Hopefully this post has given you a good overview on the types of methods available and the pros and cons of each.

Resources and Citations

Related Posts

In the Era of “Finstagram”, Snapchat Remains a Haven for Authentic Social Sharing  As marketers and brand strategists, we get a lot of questions about specific channels and how best to use them. Recently, we’ve been hearing the same set of questions quite frequently: “What’s the deal with Snapchat?”  “Is Snapchat dead?” “Why are they still around – who is even using them?!”   Surprisingly, Snapchat is not dead.  Yes, you heard that right – the app is still alive and thriving.  53% of all internet users aged between 15 and 25 years still actively use Snapchat. More fascinatingly, among this population, Snapchat is their most popular app, closely followed by Instagram. The average daily active user opens the app’s camera more than 30 times a day, spending at least 30 minutes on the app.  Users turn to the app for playful and silly content with their friends. 95% of Snapchatters say the app makes them feel happy, more than any other app tested.  This begs the question: How are so many people (in a coveted target demographic) using this platform and yet, so many people keep asking if it’s dead? The Answer: The reason people think it’s dead is actually the reason people like using it. It’s relatively free from advertisements and brands, it’s harder to track people and it offers a more authentic place to be yourself with your friends.    So, Why Snap? Think about the last time you were scrolling through Instagram. You see a post from your cousin, then one from your college friend, and then an ad about the shirt you were browsing 30 minutes ago. Nowadays, it seems like scrolling through social media has become a new form of never-ending advertising.  Now, enter Snapchat. Unlike other social platforms, Snapchat allows users an escape or ability to hide from targeted media, which is attractive to a subsection of consumers and, in our opinion, is the reason Snapchat is still very relevant for Gen Z and younger Millennials.  With Snapchat, users are able to directly share videos and images with their closest friends and choose how and when to share moments to a wider friends list. (Yes, we know Instragram added the close friends function in stories but it’s somehow not the same). Unlike Instagram or Tiktok, Snapchat users don’t appear to feel the pressure to look a certain way or feel a certain way about the amount of content they receive or share. Users are more likely to express their authentic self, not constantly comparing themselves to others based on post engagements or feed aesthetics. Snapchat also eliminates the surrounding influencer persona which surfaces on other platforms and removes the constant barrage of paid media. In other words, on Snapchat you don’t feel like you’re constantly being sold something. A Refinery 29 article points out “A big part of Snapchat’s appeal is the lack of commitment it takes to enjoy it: Stories fade after 24 hours, messages disappear, and, even if you leave Snapchat, you can always connect with people via at least three other platforms”- users do not have to feel pressured by the living content aspect of other platforms.  Essentially, Snap is a “cleaner” more authentic experience free from influencers and brands and that’s exactly why people like it.    Does this mean brands should avoid Snap all together!? By no means is Snapchat an untouched platform by brands. Brands do have targeted ads on Snapchat however, these don’t interrupt the way users engage with the app. Users only see sponsored content when looking through the wider audience stories and they know that’s the only place they’ll see ads.  Brands that use Snapchat well have become skilled at hiding their ads amongst other organic stories so much so that users sometimes don’t know they’ve clicked through a paid placement. TEVA, Sam Edelman and The New York Times are all currently running promotional campaigns on Snapchat in which users would briefly tap through the ad as if the brand had its own Snap story.                                       Additionally, through its filter feature, brands have been able to promote new products or promotions, however these filters can be seen as “tired” for Snap's core consumers.    What Should a Brand Do? How Should They Think About Snapchat? Be Purposeful & Authentic - Snap requires a lot of attention, strategy and dedication to do it well. Think About One to One - Snap is all about direct interaction. Think about adjusting your brand voice to be personified - help people feel like they’re talking to the people behind the brand, not a nameless faceless logo.  Don’t Copy & Paste Other Social Strategies - If you’re thinking about getting involved with a Snapchat presence - be prepared for a slow, long road. You can’t reuse your Instagram or TikTok strategy on this platform. Get to know how it works and then act accordingly.  Community before Mass Reach: “Going Viral” isn’t so much of a thing on Snapchat so it’s less about mass appeal and more about relationship building with a passionate group of friends and fans.  When in Doubt, Don’t - If you’re on the fence about jumping into Snapchat or reigniting your Snap presence, it’s better to be smart than be fast. No one is going to fault you for not having a Snap presence but there could be negative consequences if you do Snap poorly.    A Parting Thought From an advertising standpoint, brands can capitalize on the fast FOMO opportunities that Snap creates to promote new products or campaigns. At the same time, brands should strategically think about how to speak to consumers on the platform, especially when knowing most users turn to the app for playful and silly conversations with their closest friends. As both a user and a strategist,  Snap allows me to feel free of the social pressure felt across other platforms. However, if I were to advise a client interested in Snap, I would advise to proceed with caution as authentic social sharing seems to be harder and harder to replicate as for brands these days.  Brands are always welcomed to create a presence on Snapchat, although enticing to try to reach target audiences, the level of attention, dedicated resources, content curation and focus required to authentically join that space remains high.  Brands looking to engage may need to weigh the risks vs the possible rewards before launching campaigns on the platform or face potential blowback as consumers feel their “brand neutral space” becomes invaded. 

In our continuing series of examining Google Search Trends to gain insights into the top keywords queried in the USA, we present our findings for September 2021. Every day, we capture the top three keyword phrases in terms of search volume as reported by Google Trends (US Only). Each term has an estimated query volume attached to it, which we also record. The number scale tops out at 10,000,000+ with a lower limit of 200,000+. After the conclusion of the month, we look at the phrases we collected along with their volumes to get an understanding of what drove queries for the month.   A Return To The Typical For September 2021 After a weird August 2021, last month’s queries looked more like the ones to which we are accustomed. There were a few phrases that were queried over 10 million times.  Deadly weather events weren’t a top search topic - thank goodness - and the return of the NFL brought back many of the top team names back into the daily top 3. September did have its unique qualities too. We noticed some intriguing reporting on some Google Doodle clicks - phrases that were in the top 3 one day and then gone the next. Also, the sad story of Gabby Petito can’t be ignored as her name appeared in our capture 6 times last month. Lastly, coffee had a moment in September as a national day held in its honor was searched a bunch on the 28th. With that, let’s get into the top searched phrases of September 2021.   The Curious Clicks of Google Doodles When Google changes the logo on its homepage with what they call a Google Doodle, people click. When people click, it leads them to search results. When they are led to search results, it’s counted as a query. Here are three queries that we counted because they were attached to a Google Doodle; Christopher Reeve - 9/24/2021 - 10,000,000+ queries Google - 9/27/2021 - 10,000,000+ queries Rodolfo 'Corky' Gonzales - 9/30/2021 - 2,000,000+ queries Two of last month’s Doodle were published to celebrate the lives of people of note, the actor Christopher Reeve and political activist Rodolfo Gonzales.  The other Doodle, noted by the query “Google” was posted to celebrate the company’s 23rd birthday. One thing we noted as a team was the reporting of Google Doodle clicks on September 5th.  Since we check the daily search trends from Google Trends every day, we saw that it was initially reported that Google’s 2021 Labor Day Doodle had driven over 10 million clicks. It appeared as a query for “Labor Day” on Monday.  But since we know there is an adjustment period for these results, we recorded the top 3 queries for Sunday on Tuesday and found the Labor Day query was no longer there.  We didn’t know what to make of it. Since there were no Google Doodle-related queries in August, we wondered if Google Trends was changing how it reported Doodle clicks. If there was a change, it was temporary as we saw more Doodle clicks and the queries related to those clicks late last month.   The Non-Doodled Holidays Putting the cryptic Labor Day Doodle query aside, here are the holiday related terms that people searched for the most in September:  Rosh Hashanah - 9/5/2021 - 500,000+ queries Labor Day meaning - 9/6/2021 - 200,000+ queries 9/11 - 9/10/2021 - 1,000,000+ queries Yom Kippur - 9/15/2021 - 500,000+ queries National Coffee Day 2021 - 9/28/2021 - 200,000+ queries “Labor Day meaning” did make the top 3, interestingly enough. We interpret this query and the number associated with it are connected to a genuine interest of learning more about the holiday. The Jewish holidays of Rosh Hashanah and Yom Kippur both occurred in September this year as did the 20th anniversary of the September 11th attacks. Lastly, and we love to see this type of “holiday” query appear in the daily top 3, National Coffee Day 2021 had a resurgence as compared to the last 4 years.  The peak for this holiday may have happened in 2015 but it’s clear that more of us were searching for a way to celebrate coffee this year.   The Films and TV Shows We Watched To gauge the popularity of video entertainment, AMP Agency takes note of the search volume behind movie and television show titles.  The film industry has taken a hit and we are not sure if going to the movies will ever come back to the way it was but here are the films that drove the most search volume in September. Shang-Chi - 9/2/2021 - 1,000,000+ queries Matrix 4 - 9/9/2021 - 500,000+ queries Malignant - 9/10/2021 - 500,000+ queries Cry Macho - 9/17/2021 - 500,000+ queries Venom - 9/30/2021 - 1,000,000+ queries With the exception of Matrix 4 (that film’s trailer dropped on the 9th), all of these films were released last month.  Dancing With the Stars 2021 - 9/8/2021 - 200,000+ queries Ted Lasso - 9/19/2021 - 2,000,000+ queries Dancing with the Stars - 9/20/2021 - 500,000+ queries For TV shows, people still love Dancing With The Stars as it began its 30th season. The cast announcement and its premier episode drove people to search.  Interestingly enough, Ted Lasso is the only query related to the Emmy Awards that were held on the 19th. That show won 7 awards and may have picked up a few more viewers after the Emmys.   September 2021 News Events For these monthly analyses, we typically do not report on queries related to celebrity deaths or other tragedies unless the search volume dictates that it can’t be ignored.  Queries related to  Gabby Petito’s disappearance and death made the daily top 3 of 6 days in September. Gabby Petito - 9/15/2021 - 1,000,000+ queries Gabby Petito found - 9/16/2021 - 500,000+ queries Gabby Petito found - 9/17/2021 - 1,000,000+ queries Gabby Petito found - 9/18/2021 - 500,000+ queries Gabby Petito - 9/19/2021 - 10,000,000+ queries Gabby Petito Autopsy - 9/21/2021 - 500,000+ queries The other big news story that drove millions of queries was related to the California recall election.  Californa recall election - 9/13/2021 - 2,000,000+ queries California recall election - 9/14/2021 - 5,000,000+ queries It’s interesting to see the number of queries increased the day after the election as people wanted to learn of the results.    Gaming  Keywords related to video games make the top 3 rarely so we thought it was a treat to see three phrases last month. Deltarune - 9/16/2021 - 100,000+ queries Nintendo Direct - 9/22/2021 - 200,000+ queries New World - 9/27/2021 - 200,000+ queries The second chapter of the Deltarune game was released on the 16th and New World was released by Amazon Games on the 28th.  Nintendo Direct announced all the games updates for their Switch console that are rolling out this winter.   Just the Top Sports Keywords Of the 90 phrases we collected in September, 37 were related to sports.  Since there were so many, let’s just keep it to the keywords that were queried 2 million times or more: Dallas Cowboys - 9/9/2021 - 5,000,000+ queries Georgia football - 9/4/2021 - 2,000,000+ queries Parkers - 9/12/2021 - 2,000,000+ queries Cleveland Browns - 9/12/2021 - 2,000,000+ queries NFL - 9/12/2021 - 2,000,000+ queries Raiders - 9/13/2021 - 2,000,000+ queries Thursday Night Football - 9/16/2021 - 2,000,000+ queries Ravens - 9/19/2021 - 2,000,000+ queries Packers - 9/20/2021 - 2,000,000+ queries Christian McCaffrey - 9/23/2021 - 2,000,000+ queries UFC - 9/25/2021 - 2,000,000+ queries Dallas Cowboys - 9/26/2021 - 2,000,000+ queries Packers - 9/26/2021 - 2,000,000+ queries Chiefs - 9/26/2021 - 2,000,000+ queries Bengals - 9/30/2021 - 2,000,000+ queries Yes, gridiron football is back and the stadiums are filled with people. You can see the NFL dominate the number of sports keywords in this list.  The Dallas Cowboys and the Green Bay Packers seem to be winning the popularity contest so far this season.   Apple News A new iPhone?  Oh, you know people want to know more about that.  The iPhone 13 series was unveiled on the 14th and the latest iOS version was released on the 20th.   iPhone 13 - 9/14/2021 - 2,000,000+ queries iOS 15 - 9/20/2021 - 500,000+ queries All in all, a good month for Apple. If they ever launch a search engine, they can celebrate their company’s birthday with a doodle of their own. Thanks for reading. If you liked this article, we utilize search trends data for all of our clients and we invite you to learn more about our SEO services. Until next month.

In my neighborhood in Portland, Oregon, many of the sidewalks are original - built when the neighborhood was coming together in the early part of the 20th century. You can locate stamps at intersections that have both obsolete street names - Sprague Street is now known as Rosemont; Margarette is now 34th Ave - and the names the contractors who poured the cement, along with the year they were poured. These small reminders of the recent past are fun to find, but point out a glaring inequity in their construction: These old sidewalks are not accessible, and not safe. An unimproved intersection The city is in the process of converting each of the city’s intersections into curb cutouts that are friendlier to those who may require assistance (wheelchairs, kneeling scooters, crutches, probing canes) getting up and onto sidewalks from the street. The brand new curb cutouts include a yellow rubberized traction pad that signals the transition between street and sidewalk, and there are eight on each improved intersection - two on each corner of a standard intersection. An improved intersection. This effort is happening not because the improvements and bright yellow traction pads are attractive, or because the contrast between the fresh cement and the old cement is nice to look at - but because it is the right thing to do for the citizens of Portland and those who have mobility issues who might otherwise need to be in the street in order to avoid the curb. This abides by the regulations set forth in American with Disabilities Act of 1990 (ADA). The benefits go beyond supporting only people who have disabilities, though - anyone who has tried to use a rolling suitcase on the sidewalk, pushed a baby stroller over a curb, or can’t ollie on a skateboard can attest to that. By doing the right thing, Portland has chosen to make their city more accessible to more of its citizens. In our web development projects, we often support clients who need to do the equivalent curb-cutout improvements. Their sites may have been beautifully designed, but fall short in visual and technical areas that would help make their site more accessible. By bringing the site up to a baseline of accessibility standards set forth by the WCAG, the site becomes more equitable, inclusive, and usable for more people. The add-on effect for the client is that they have just widened their potential customer base by not excluding people who may consume web information in different ways. The improvement process also helps shake out other technical issues around markup structure, meaning the site may become more SEO-friendly and may render better in a wider range of devices after the improvements are implemented. While these efforts may be initially driven by legal justification (avoiding ADA lawsuits), or for marketing reasons (reaching more customers), improving your site’s accessibility is the just and correct thing to do. Our process begins by using a suite of tools that analyze the website to identify problem areas. This includes using voice-reader to read the website’s content - not everyone who browses your website will use their eyes to do so. We also see how the site renders without styles applied, validate the markup of the site to ensure the proper document structure & hierarchy is established, and closely scrutinize how interactive elements work. Particularly complex interactive elements like carousels or interactive navigation menus may require an entire rebuild in order to be accessible, but the goal is to maintain the current design or as close to it as possible. The end result of such an effort should not sacrifice visual design or interactivity, nor should it even be noticeable to those users who use standard means to interact with websites. But for those who need assistance, the improvements are welcome and appreciated. For sites that we build from scratch, we design and develop with this equity in mind from the beginning. By starting off with a requirement of accessibility, the new site enters the digital world already with accessibility in place. The level of accessibility, set forth by WCAG standards - “A” to “AAA”, with the latter being the most strict - may be dictated by the customer’s requirements. Projects for larger clients, non-profits, or government clients typically have a minimum accessibility level mandate for digital properties. But even for those without the mandate, doing the right thing results in a site that behaves nicely across different input types and allows for a wider audience to engage with the site. Do you need help with your site’s accessibility? Are you concerned your site is unintentionally excluding users?