{"id":13515644,"url":"https://github.com/lookbook-hq/lookbook","last_synced_at":"2025-04-13T14:06:42.742Z","repository":{"id":37440896,"uuid":"380261205","full_name":"lookbook-hq/lookbook","owner":"lookbook-hq","description":"A UI development environment for Ruby on Rails apps ✨","archived":false,"fork":false,"pushed_at":"2025-04-01T14:52:02.000Z","size":60801,"stargazers_count":963,"open_issues_count":29,"forks_count":103,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-13T02:15:45.061Z","etag":null,"topics":["components","development","lookbook","partials","phlex","rails","ruby","ruby-on-rails","styleguide","viewcomponent"],"latest_commit_sha":null,"homepage":"https://lookbook.build","language":"JavaScript","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/lookbook-hq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2021-06-25T14:20:54.000Z","updated_at":"2025-04-03T17:25:01.000Z","dependencies_parsed_at":"2024-04-17T10:42:03.406Z","dependency_job_id":"9dc86865-d861-4407-9ec2-029b4a0be8d1","html_url":"https://github.com/lookbook-hq/lookbook","commit_stats":{"total_commits":1471,"total_committers":68,"mean_commits":21.63235294117647,"dds":0.1828687967369137,"last_synced_commit":"d35a96cba55e21a491cdb2a6863a24299103cd17"},"previous_names":["lookbook-hq/lookbook","viewcomponent/lookbook"],"tags_count":137,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lookbook-hq%2Flookbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lookbook-hq%2Flookbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lookbook-hq%2Flookbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lookbook-hq%2Flookbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lookbook-hq","download_url":"https://codeload.github.com/lookbook-hq/lookbook/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248654105,"owners_count":21140237,"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":["components","development","lookbook","partials","phlex","rails","ruby","ruby-on-rails","styleguide","viewcomponent"],"created_at":"2024-08-01T05:01:14.103Z","updated_at":"2025-04-13T14:06:42.722Z","avatar_url":"https://github.com/lookbook-hq.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Miscellaneous"],"sub_categories":["Rails codebases to study"],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cbr\u003e\n\u003cp\u003e\u003ca href=\"https://lookbook.build\"\u003e\u003cimg src=\".github/assets/lookbook_logo.svg\" width=\"240\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp\u003eA UI development environment for Ruby on Rails applications.\u003c/p\u003e\n\n\u003cp\u003e\u003cstrong\u003e\u003ca href=\"https://lookbook.build\"\u003eDocumentation\u003c/a\u003e \u0026nbsp;|\u0026nbsp; \u003ca href=\"http://demo.lookbook.build/lookbook\"\u003eDemo site\u003c/a\u003e\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp\u003e\u003ca href=\"https://rubygems.org/gems/lookbook\"\u003e\u003cimg src=\"https://img.shields.io/gem/v/lookbook\" alt=\"Gem version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/lookbook-hq/lookbook/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/lookbook-hq/lookbook/actions/workflows/ci.yml/badge.svg\" alt=\"CI status\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\nLookbook combines a powerful \u003cstrong\u003ecomponent browser\u003c/strong\u003e and \u003cstrong\u003epreview system\u003c/strong\u003e with an \u003cstrong\u003eintegrated documentation engine\u003c/strong\u003e to help teams build robust, modular, maintainable user interfaces.\u003cbr\u003e\u003cbr\u003e\nIt's compatible with \u003ca href=\"https://viewcomponent.org/\"\u003eViewComponent\u003c/a\u003e, \u003ca href=\"https://www.phlex.fun/\"\u003ePhlex\u003c/a\u003e, ActionView partials and more.\n\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"https://lookbook.build\"\u003e\u003cstrong\u003eRead the docs \u0026rarr;\u003c/strong\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n\n---\n\n[![Lookbook UI](.github/assets/lookbook_ui.png)](http://lookbook.build/)\n\n## Development\n\nLookbook is implemented as an isolated [Rails Engine](https://guides.rubyonrails.org/engines.html) and uses [ViewComponent](https://viewcomponent.org), [Tailwind](https://tailwindcss.com/) and [Alpine](https://alpinejs.dev/) for its UI.\n\nThis repository contains:\n\n* The Lookbook source code ([`/app`](https://github.com/lookbook-hq/lookbook/tree/main/app), [`/lib`](https://github.com/lookbook-hq/lookbook/tree/main/lib), [`/config`](https://github.com/lookbook-hq/lookbook/tree/main/config), etc)\n* The Lookbook [documentation site](#docs-site) source code and content ([`/docs`](https://github.com/lookbook-hq/lookbook/tree/main/docs)).\n* A [test suite](#testing) with a 'runable' dummy app ([`/spec`](https://github.com/lookbook-hq/lookbook/tree/main/spec)).\n\n### Documentation site\n\nThe [Lookbook docs site](https://lookbook.build) is built using [Bridgetown](https://www.bridgetownrb.com/) and the source files can be found in the `./docs` directory.\n\nTo preview changes locally you can run a development version of the docs site:\n\n1. Clone this repo\n2. Install dependencies: `bundle install`\n3. Start the app: `bin/docs`\n4. Visit http://localhost:4000 \n\n### Testing\n\nLookbook uses [RSpec](https://relishapp.com/rspec). [Appraisal](https://github.com/thoughtbot/appraisal) is used to run tests against different Ruby and Rails versions.\n\nTests can be run using the `bundle exec appraisal rspec` command.\n\nThe dummy app that the tests are being run against can be viewed by running the `bin/dummy` command and then browsing to http://localhost:9292/lookbook\n\n### Releases\n\nLookbook uses [Release It!](https://github.com/release-it/release-it) to automate the release process.\n\nRunning `npm run release` will start the process of publishing a new release and walks though all the steps from picking a version number to publishing the updated gem.\n\nPublishing a release requires write permissions for this repository (lookbook-hq/lookbook) and 2FA publish permissions for Lookbook on RubyGems.\n\n## Contributing\n\nLookbook is an un-funded open source project and contributions of all types and sizes are most welcome!\n\nPlease take the time to read over the [Contributing](./CONTRIBUTING.md) guide before making your first contribution and if anything isn't clear then [start a discussion](https://github.com/lookbook-hq/lookbook/discussions) and we will do our best to help you out.\n\n## Contributors \n\nLookbook was created by [Mark Perkins](https://github.com/allmarkedup) and continues to grow\n\u0026amp; improve thanks to the ideas, suggestions and hard work of all of [these excellent humans](https://github.com/lookbook-hq/lookbook/graphs/contributors):\n\u003cbr\u003e\n\u003cbr\u003e\n\u003ca href=\"https://github.com/lookbook-hq/lookbook/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=lookbook-hq/lookbook\u0026columns=14\" width=\"800\" /\u003e\n\u003c/a\u003e\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flookbook-hq%2Flookbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flookbook-hq%2Flookbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flookbook-hq%2Flookbook/lists"}