{"id":14990084,"url":"https://github.com/guangliang2019/prototype-ui","last_synced_at":"2025-04-12T02:03:52.533Z","repository":{"id":252357562,"uuid":"840178061","full_name":"guangliang2019/Prototype-UI","owner":"guangliang2019","description":"Headless UI with Web Component","archived":false,"fork":false,"pushed_at":"2025-04-11T04:37:25.000Z","size":2128,"stargazers_count":13,"open_issues_count":11,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-12T02:03:44.909Z","etag":null,"topics":["collaboration","headlessui","mit-license","prototype-ui","shadcn-ui","ui-components","web-components"],"latest_commit_sha":null,"homepage":"https://prototype-ui.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guangliang2019.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-08-09T06:15:41.000Z","updated_at":"2025-04-11T04:37:29.000Z","dependencies_parsed_at":"2024-08-09T08:45:57.658Z","dependency_job_id":"26226383-cf29-419a-8d7f-18ed7d5275ea","html_url":"https://github.com/guangliang2019/Prototype-UI","commit_stats":{"total_commits":61,"total_committers":3,"mean_commits":"20.333333333333332","dds":"0.049180327868852514","last_synced_commit":"322ba11dfeedecc46d1092bce73e4a7a9b43561f"},"previous_names":["guangliang2019/prototype-ui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guangliang2019%2FPrototype-UI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guangliang2019%2FPrototype-UI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guangliang2019%2FPrototype-UI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guangliang2019%2FPrototype-UI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guangliang2019","download_url":"https://codeload.github.com/guangliang2019/Prototype-UI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505863,"owners_count":21115354,"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":["collaboration","headlessui","mit-license","prototype-ui","shadcn-ui","ui-components","web-components"],"created_at":"2024-09-24T14:19:26.206Z","updated_at":"2025-04-12T02:03:52.506Z","avatar_url":"https://github.com/guangliang2019.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prototype UI\n\n## Overview\n\nPrototype UI is a headless UI library built with Web Components, offering a novel approach to component integration. Inspired by shadcn/ui, it bypasses traditional package management by directly incorporating component source code into your project via a CLI. This provides unparalleled customization and control, allowing you to tailor the components directly within your codebase while maintaining a lightweight footprint.\n\nWebsite: [https://prototype-ui.dev](https://prototype-ui.dev)\n\n## Features\n\n- **Non-Package Distribution**: Instead of traditional package installation, components are seamlessly integrated into your project through our CLI, promoting a more tailored development experience.\n- **Customizable**: Full code transparency allows you to modify and adapt components to meet your specific requirements.\n- **Accessibility**: Committed to the latest accessibility standards, ensuring usability for all users.\n- **Lightweight**: The entire library contributes less than 10 KB to your project, emphasizing efficiency and performance.\n\n## Installation (Working in Progress)\n\n```bash\nnpx @prototype-ui/cli init\n# Or for a specific theme:\nnpx @prototype-ui/cli init\n(and choose your prefer theme in an interactive menu)\n```\n\n# Usage\n\n```shell\n$ npx @prototype-ui/cli --help\n\n\n██████╗ ██████╗  ██████╗ ████████╗ ██████╗\n██╔══██╗██╔══██╗██╔═══██╗╚══██╔══╝██╔═══██╗\n██████╔╝██████╔╝██║   ██║   ██║   ██║   ██║\n██╔═══╝ ██╔══██╗██║   ██║   ██║   ██║   ██║\n██║     ██║  ██║╚██████╔╝   ██║   ╚██████╔╝\n╚═╝     ╚═╝  ╚═╝ ╚═════╝    ╚═╝    ╚═════╝\n████████╗██╗   ██╗██████╗ ███████╗    ██╗   ██╗██╗\n╚══██╔══╝╚██╗ ██╔╝██╔══██╗██╔════╝    ██║   ██║██║\n   ██║    ╚████╔╝ ██████╔╝█████╗█████╗██║   ██║██║\n   ██║     ╚██╔╝  ██╔═══╝ ██╔══╝╚════╝██║   ██║██║\n   ██║      ██║   ██║     ███████╗    ╚██████╔╝██║\n   ╚═╝      ╚═╝   ╚═╝     ╚══════╝     ╚═════╝ ╚═╝\n\nUsage: prototype-ui [options] [command]\n\nCLI for prototype-ui project\n\nOptions:\n  -v, --version       Output the current version\n  -h, --help          display help for command\n\nCommands:\n  init                Initialize a new prototype-ui project\n  add \u003ccomponent\u003e     Add a new component to the project\n  remove \u003ccomponent\u003e  Remove a component from the project (maybe not safe)\n  list                List all components in the project\n  help [command]      display help for command\n```\n\n## Note\n\nThe code is provided \"as is\" for maximum flexibility in use and integration into various projects.\n\n## Contributing\n\nContributions are welcome and encouraged. Although the Web Components ecosystem may not be as extensive as those for frameworks like React, Vue, or Lit, Prototype UI strives to emulate best practices from these established communities. We convert and reimplement functionalities from these frameworks into Web Components, diligently crediting original developers and their contributions.\n\n## Development\n\nRun the project locally with `npm run dev`. For optimal performance, Node version 18 or higher is recommended.\n\n## Guangliang's Note\n\nFor smaller projects or situations where CLI integration isn't ideal, you can include the entire Prototype UI library via a script tag. This method is also efficient (projected output size under 30KB) and provides a quick way to get started. However, it offers less granular control over individual components. See the documentation for details on script tag integration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguangliang2019%2Fprototype-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguangliang2019%2Fprototype-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguangliang2019%2Fprototype-ui/lists"}