js/webawesome
1
0
Fork 0
mirror of https://github.com/shoelace-style/webawesome.git synced 2026-01-12 12:09:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add problems section

Browse Source
This commit is contained in:
Cory LaViska
2020-07-13 17:42:20 -04:00
parent cc567a6c70
commit ccb8d90b8a
1 changed files with 19 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/getting-started/overview.md
View File

@@ -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.
<small>*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.</small>
## Browser Support
Shoelace is tested in the latest two versions of the following browsers.