{"id":13805043,"url":"https://github.com/kjantzer/bui","last_synced_at":"2025-04-05T02:04:54.625Z","repository":{"id":38153289,"uuid":"204566076","full_name":"kjantzer/bui","owner":"kjantzer","description":"‹B› Web components, classes, and utilities for creating single-page PWAs – built with Lit by Blackstone Publishing","archived":false,"fork":false,"pushed_at":"2025-02-27T04:14:26.000Z","size":53337,"stargazers_count":98,"open_issues_count":17,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T01:03:45.116Z","etag":null,"topics":["buildwithlit","custom-elements","design-system","javascript","lit","lit-element","lit-html","lit-html-element","ui-components","ui-framework","ui-library","web-components","webcomponents"],"latest_commit_sha":null,"homepage":"https://bui.js.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kjantzer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-26T21:37:44.000Z","updated_at":"2025-03-14T16:13:56.000Z","dependencies_parsed_at":"2023-12-06T01:36:51.232Z","dependency_job_id":"31097495-631d-418e-b66a-9c8f8a590ea4","html_url":"https://github.com/kjantzer/bui","commit_stats":{"total_commits":3736,"total_committers":9,"mean_commits":415.1111111111111,"dds":"0.24223768736616702","last_synced_commit":"41eb9a861387c45faf60da7d9a2d03499ebfd931"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjantzer%2Fbui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjantzer%2Fbui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjantzer%2Fbui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjantzer%2Fbui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kjantzer","download_url":"https://codeload.github.com/kjantzer/bui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247217174,"owners_count":20903008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["buildwithlit","custom-elements","design-system","javascript","lit","lit-element","lit-html","lit-html-element","ui-components","ui-framework","ui-library","web-components","webcomponents"],"created_at":"2024-08-04T01:00:56.824Z","updated_at":"2025-04-05T02:04:49.616Z","avatar_url":"https://github.com/kjantzer.png","language":"JavaScript","readme":"\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/kjantzer/bui\" rel=\"noopener\" target=\"_blank\"\u003e\n    \u003cimg width=\"200\" src=\"https://raw.githubusercontent.com/kjantzer/bui/master/logo.png\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eBlackstone UI (BUI)\u003c/h1\u003e\n\nWeb components for creating interfaces - built with [Lit](https://lit.dev/) by [Blackstone Publishing](https://blackstonepublishing.com)\n\n\u003cdiv align=\"center\"\u003e\n\n[![demo](https://img.shields.io/badge/-Demo%20\u0026%20Documentation-blue)](https://bui.js.org)\n\n\u003c/div\u003e\n\n[![preview](./preview.jpg)](https://bui.js.org)\n\n## 🎉 Features\n- 📱 Progressive scaling from desktop to mobile devices\n- 🌗 Dark/Light Mode\n- 🎨 Color Themes\n- 🧑‍💻 Modern async/await style structure\n- 🛠 Customizable with css vars and \"parts\"\n- 🔗 Extensible and interoperable with other frameworks\n- ⚓️ URL route management\n\n## ℹ️ Overview\n\nThe stable release of v1 [web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) with the addition of [lit](https://lit.dev) make for an incredible framework for writing user interface components.\n\nShadow DOM, CSS [custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties), and css [\"parts\"](https://developer.mozilla.org/en-US/docs/Web/CSS/::part) makes encapsulation easy yet still customizable.\n\n**BUI is a library** of low level custom elements, full featured \"presenters\", useful utility functions, application router, code extension \"helpers\", node.js server classes (for creating RESTful APIs), and more. \n\n**Import and use a select few components or use most of it to create a full featured application.**\n\n⭐️ The [demo/documention](http://bui.js.org/) is an example of what can be built with BUI and a good resource for reading more about what the library offers.\n\n## ⬇️ Installation\nBUI is actively developed on a daily basis by [Blackstone Publishing](https://www.blackstonepublishing.com). It is used in multiple internal application production environments. New features, changes, and bug fixes occur weekly - however, it may be slower to reach this public repo.\n\nAlthough BUI is available as an [npm package](https://www.npmjs.com/package/blackstone-ui), the library is updated too frequently to publish consistent versions. \n\n**Installing the latest is recommended:**\n\n```\nnpm install https://github.com/kjantzer/bui.git --save\n```\n\nWe will attempt to document *major breaking* changes in the changelog. If you find any bugs/issues, please report or submit a PR.\n\n## 🚀 Getting Started\n\nCloning and runing the demo/docs locally on your computer would be a good place to start. From there you can see how the various components work together to create an application.\n\nInstall parcel globally if you don't already have it installed\n```bash\n$ npm install -g parcel-bundler\n```\n\nInstall the dependencies, then start the demo app\n```bash\n$ git clone https://github.com/kjantzer/bui.git\n$ cd bui\n$ npm install\n$ npm start\n```\n\nYou should then be able to view the demo at:  \nhttp://localhost:1234\n\n## 🚨 Notice\n\nSince BUI is actively developed nearly every day and done so by a small team, the documentation likely won't be 100% up to date. You may need to reference the physical code to discover some options/settings.\n\nNo software is bug free, but the latest commit of BUI should be fairly stable as it is used in a production environment at Blackstone.\n","funding_links":[],"categories":["Real World","Component Libraries"],"sub_categories":["Component Libraries"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkjantzer%2Fbui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkjantzer%2Fbui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkjantzer%2Fbui/lists"}