https://github.com/placer-toolkit/placer-toolkit
The go‐to web component library for the web! 🛠️
https://github.com/placer-toolkit/placer-toolkit
components custom-elements lit litelement placer placer-toolkit toolkit web-components
Last synced: 19 days ago
JSON representation
The go‐to web component library for the web! 🛠️
- Host: GitHub
- URL: https://github.com/placer-toolkit/placer-toolkit
- Owner: placer-toolkit
- License: mit
- Created: 2025-05-13T14:44:21.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-08T15:44:14.000Z (10 months ago)
- Last Synced: 2025-08-16T05:02:58.242Z (10 months ago)
- Topics: components, custom-elements, lit, litelement, placer, placer-toolkit, toolkit, web-components
- Language: TypeScript
- Homepage: https://placer-toolkit-b854c7b0.netlify.app
- Size: 954 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 
### Flexible. Accessible. Web Components.
> [!NOTE]
> 📦 This is a **monorepo** containing the Placer Toolkit core and its documentation site.
## 🚧 Alpha notice
This is an **alpha** version of Placer Toolkit. Expect instabilities and bugs; if you find one, please open an issue or submit a PR to improve this project.
## 🛠️ Custom Placer Toolkit builds
If you want to create custom builds of Placer Toolkit, you can use this documentation to learn how to build Placer Toolkit from source. You will need Node.js v20 or later (v21 is not supported) to build and run the project locally.
You don’t need any of this to use Placer Toolkit. This section is for contributors or anyone who wants to tinker with the source or create custom builds of Placer Toolkit.
1. Start by [forking the repo](https://github.com/placer-toolkit/placer-toolkit/fork) on GitHub, then clone it locally and install dependencies.
```shell
git clone https://github.com/placer-toolkit/placer-toolkit
cd placer-toolkit # Navigates into your clone
npm install # Installs dependencies for Placer Toolkit
cd docs
npm install # Installs dependencies for Placer Toolkit’s docs
```
2. Once you’ve cloned the repo, you can run the following command to spin up the development server for the docs. Make sure you’re in the `docs` folder of the project.
```shell
npm run dev # Spins up the dev server provided by Astro
npx astro dev --host # If you want to expose the server on your network
```
This will spin up the dev server on `localhost:4321`. There isn’t any hot module reloading as Web Components aren’t compatible with this technology, but it’ll automatically refresh the page instead.
3. To build the docs, run this command in the `docs` folder.
```shell
npm run build # Builds the project. Also initialises Pagefind on‐the‐go
npm run preview # Spins up the production server provided by Astro
```
## 📄 Licence
This project uses a modular licensing system and different parts of the codebase are licensed under different licences.
- **Library:** MIT License
- **Documentation:** CC BY 4.0
- **Logos:** CC BY-ND 4.0 with exceptions listed in the [Brand assets guidelines](https://placer-toolkit.vercel.app/docs/resources/brand-assets)
- **Branding and marketing assets:** All rights reserved with a contributor licence grant
See the [licence page](https://placer-toolkit.vercel.app/docs/legal/licence) for more information.
## 💖 Special thanks
Placer Toolkit was built with the help of these fantastic libraries:
- [Lit](https://lit.dev)
- [Astro](https://astro.build)
- [Floating UI](https://floating-ui.com)
- [Custom Elements Manifest](https://custom-elements-manifest.open-wc.org)
- [Pagefind](https://pagefind.app)
Additionally, Placer Toolkit is heavily inspired by [Web Awesome](https://webawesome.com)—a meticulously designed and highly customisable web component library. Web Awesome is licensed under the [MIT License](./licenses/@awesome.me/webawesome/LICENSE.md).
The default icon set is [Font Awesome](https://fontawesome.com) which is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0).
For the entire list of open‐source libraries and frameworks, see [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) for more information.
© 2025–present Placer and its contributors