Skip to content
Get packs

Shoelace

A sunset library of web components; development has moved to Web Awesome.

GitHub Download v2.20.1
Stars
13.8k
Forks
911
Licence
MIT
Language
TypeScript
Last update
6 months ago
Type
Library

This repository is archived and no longer maintained.

What it is

Shoelace is a library of prebuilt user interface pieces (web components) that web developers can drop into pages built with any framework or plain HTML. The README says the project is now sunset, meaning it has no active development, and that its successor is Web Awesome. The library remains available under the MIT license for existing use.

  • Keep an existing Shoelace-based site running under the MIT license
  • Read the source to see how LitElement components are built with esbuild
  • Follow the official migration guide to move to Web Awesome

Great for

  • Developers maintaining an existing site that already uses Shoelace
  • Teams studying the source code of an older web component library
  • People planning a migration to Web Awesome

Not ideal for

  • New projects: the README directs new work to Web Awesome, since this codebase no longer gets development
  • Anyone who needs bug fixes or feature requests: the README says this repository is not accepting issues or pull requests

How to get it

  1. 1

    Clone and build from source

    You'll need: Node.js 14.17 or later

    Clone the repository

    git clone https://github.com/YOUR_GITHUB_USERNAME/shoelace

    Install dependencies

    npm install
  2. 2

    Run it

    • Read the README note that the project is sunset and check the migration guide at webawesome.com
    • Clone the repository and run npm install in the folder
    • Run npm start to launch the dev server, which opens a browser automatically
    • Run npm run build to create a production build
  3. 3

    Get the most out of it

    • Follow the migration guide to move existing code to Web Awesome
    • Use the documentation site at shoelace.style for usage details, as the README says installation is covered there
    • Treat the source as historical reference for auditing or private forks

Downloads

Source code (.zip)next branch · straight from GitHubRelease v2.20.1Release notes and sourceOfficial website & docswebawesome.com

Strengths

  • Components are described as usable with any framework or from a CDN
  • The README states it is built with accessibility in mind and includes a dark theme
  • Licensed under MIT, so existing use is permitted

Trade-offs

  • No active development; the README says issues and pull requests are not accepted here
  • The README points new users to Web Awesome, so new projects should start there instead

How it compares

ProjectStarsTypeLevelUpdatedBest for
shoelace (this)13.8kLibraryintermediate6 months agoDevelopers maintaining an existing site that already uses Shoelace
hyperui12.3kLibrarybeginner11 days agoDevelopers building marketing sites with Tailwind CSS
bootstrap175kLibrarybeginner4 days agoDevelopers building responsive websites or web app interfaces quickly
bulma50kLibrarybeginner2 months agoDevelopers who want a quick, consistent styling baseline for a web page
layui30.6kLibrarybeginner4 days agoDevelopers maintaining existing sites or admin panels built on Layui
gentelella21.6kLibraryintermediate6 days agoDevelopers who want a starting point for an internal admin panel without adopting a frontend framework

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.