From ccb8d90b8a3e65a323aeb4faeb38e6119483806d Mon Sep 17 00:00:00 2001 From: Cory LaViska Date: Mon, 13 Jul 2020 17:42:20 -0400 Subject: [PATCH] Add problems section --- docs/getting-started/overview.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/docs/getting-started/overview.md b/docs/getting-started/overview.md index 1a0206749..f3cdc7011 100644 --- a/docs/getting-started/overview.md +++ b/docs/getting-started/overview.md @@ -26,9 +26,9 @@ Now you have access to all of Shoelace's components! Try adding a button: See the [installation instructions](getting-started/installation.md) for more details and other ways to install Shoelace. -## New to web components? +## New to Web Components? -**TL;DR** – we finally have a way to create our own HTML elements and use them in any framework we want! +**TL;DR** – we finally have a way to create [our own HTML elements](https://html.spec.whatwg.org/multipage/custom-elements.html) and use them in any framework we want! Thanks to the popularity of frameworks such as Angular, Vue, and React, component-driven development has become a part of our every day lives. Components help us encapsulate styles and behaviors into reusable building blocks. They make a lot of sense in terms of design, development, and testing. @@ -38,10 +38,26 @@ Unfortunately, _framework-specific_ components fail us in a number of ways: - Their lifespan is limited to that of the framework's ⏳ - New framework versions can lead to breaking changes, requiring substantial effort to update components 😭 -Web components solve these problems. They're [supported by all modern browsers](https://caniuse.com/#feat=custom-elementsv1), they're framework-agnostic, and they're [part of the spec](https://www.webcomponents.org/specs), so we know they'll be supported for many years to come. +Web components solve these problems. They're [supported by all modern browsers](https://caniuse.com/#feat=custom-elementsv1), they're framework-agnostic, and they're [part of the standard](https://developer.mozilla.org/en-US/docs/Web/Web_Components), so we know they'll be supported for many years to come. This is the technology that Shoelace is built on. +## What Problems Does This Solve? + +Shoelace provides a collection of professionally designed, every day UI components built on a framework-agnostic technology. Why spend hundreds of hours or more building a design system from scratch? Why make a component library that only works with one framework? + +With Shoelace, you can: + +- Start building things faster (no need to roll your own buttons or inputs) +- Build multiple apps in different frameworks that all share the same UI +- Stop worrying about new component libraries when you switch frameworks + +If your organization is looking to build a design system, [Shoelace will save you thousands of dollars](https://medium.com/eightshapes-llc/and-you-thought-buttons-were-easy-26eb5b5c1871).* All the foundational components you need are right here, ready to be customized for your brand. + +Whether you use Shoelace as a starting point for your organization's design system or for a fun personal project, there's no limit to what you can do with it. + +*You're more than welcome to do this, but please [support the project with a sponsorship](https://github.com/sponsors/claviska) to continue its development. + ## Browser Support Shoelace is tested in the latest two versions of the following browsers.