{"id":15138061,"url":"https://github.com/nicopap/cuicui_layout","last_synced_at":"2025-10-23T13:31:05.556Z","repository":{"id":176547024,"uuid":"658396703","full_name":"nicopap/cuicui_layout","owner":"nicopap","description":"The dumbest and simplest layouting algorithm for bevy","archived":false,"fork":false,"pushed_at":"2023-11-15T18:03:01.000Z","size":2162,"stargazers_count":41,"open_issues_count":32,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-30T18:51:54.212Z","etag":null,"topics":["bevy","cuicui","framework","layout","rust","ui"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/nicopap.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"licenses/LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["nicopap"]}},"created_at":"2023-06-25T16:10:08.000Z","updated_at":"2024-12-08T11:57:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"9f8a9b13-0f41-4484-9dd9-7af38f44ec02","html_url":"https://github.com/nicopap/cuicui_layout","commit_stats":null,"previous_names":["nicopap/cuicui_layout"],"tags_count":67,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fcuicui_layout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fcuicui_layout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fcuicui_layout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicopap%2Fcuicui_layout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicopap","download_url":"https://codeload.github.com/nicopap/cuicui_layout/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237834730,"owners_count":19373783,"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":["bevy","cuicui","framework","layout","rust","ui"],"created_at":"2024-09-26T07:20:22.162Z","updated_at":"2025-10-23T13:31:05.153Z","avatar_url":"https://github.com/nicopap.png","language":"Rust","funding_links":["https://github.com/sponsors/nicopap"],"categories":[],"sub_categories":[],"readme":"[![Bevy tracking](https://img.shields.io/badge/Bevy%20tracking-released%20version-lightblue)](https://github.com/bevyengine/bevy/blob/main/docs/plugins_guidelines.md#main-branch-tracking)\n[![Latest version](https://img.shields.io/crates/v/cuicui_layout.svg)](https://crates.io/crates/cuicui_layout)\n[![MIT/Apache 2.0](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)](./LICENSE)\n[![The Book](https://img.shields.io/badge/The_Cuicui_Book-blue)](https://cuicui.nicopap.ch/introduction.html)\n\n# The Cuicui Framework\n\nThe `cuicui` framework is a collection of rust crates made for bevy.\n\n- [`cuicui_layout`]: A dumb layout algorithm you can rely on, built for and with bevy.\n- [`cuicui_dsl`] and [`cuicui_chirp`]: Two enjoyable ways to spawn scenes in bevy.\n\n\u003cdetails\u003e\u003csummary\u003e\u003cb\u003eThe Chirpunk demo\u003c/b\u003e\u003c/summary\u003e\n\nFor some reasons, the Cyberpunk main menu has become the 7GUI of bevy, so here\nis the Cyberpunk main menu using `cuicui_layout_bevy_ui`.\n\nhttps://user-images.githubusercontent.com/26321040/272480834-e964565b-44bb-4363-8955-19515624d71a.mp4\n\n| **❗ Hot reloading disclaimer ❗** |\n|------------------------------------|\n\nChirp hot reloading with `bevy_ui` components (ie: using `cuicui_layout_bevy_ui`)\nis broken due to \u003chttps://github.com/bevyengine/bevy/pull/9621\u003e.\nYou may want to work on a local patched version of bevy.\nA workaround will probably be provided in cuicui 0.10.\n\nThe code for the video demo can be read in [the chirpunk example].\n\n\u003c/details\u003e\n\n## Hello World\n\nA tinny example to get you an idea of what you can do with `cuicui`.\n\nShows a blue box with cyan outline in the center of the screen:\n\n```rust,no_run\nuse bevy::prelude::*;\nuse cuicui_layout::{dsl, LayoutRootCamera};\nuse cuicui_layout_bevy_ui::UiDsl as Dsl;\n\nfn main() {\n    // Do not forget to add cuicui_layout_bevy_{ui,sprite}::Plugin\n    App::new()\n        .add_plugins((DefaultPlugins, cuicui_layout_bevy_ui::Plugin))\n        .add_systems(Startup, setup)\n        .run();\n}\nfn setup(mut commands: Commands) {\n    // Use LayoutRootCamera to mark a camera as the screen boundaries.\n    commands.spawn((Camera2dBundle::default(), LayoutRootCamera));\n\n    dsl! { \u0026mut commands.spawn_empty(),\n        // Use screen_root to follow the screen's boundaries\n        Entity(row screen_root) {\n            // Stuff is centered by default.\n            Entity(row margin(9.) border(5, Color::CYAN) bg(Color::NAVY)) {\n                Entity(ui(\"Hello world!\"))\n            }\n        }\n    };\n}\n```\n\n## Running examples\n\nUse the `cargo run --bin` command to list possible examples, and run them.\n\nWe do this because it allows us to have different dependencies between examples.\n\n## Using `cuicui_layout`\n\nThe [Usage section of the book][book-usage] is a good starting point.\n\n### MOAR DOCS!!\n\n- [The cuicui Book]\n\n### For the lazy\n\nPlease read the [Usage section of the book][book-usage]. Skip to the code\nif you don't care for explanations.\n\n### Change log\n\nSee the [./CHANGELOG.md](./CHANGELOG.md) file.\n\n### Version matrix\n\n| bevy | latest supporting version |\n|------|-------|\n| 0.12 | 0.12.0 |\n| 0.11 | 0.10.2 |\n| 0.10 | 0.3.0 |\n\n## License\n\nLicensed under either of\n\n * Apache License, Version 2.0 ([LICENSE-APACHE](licenses/LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n * MIT license ([LICENSE-MIT](licenses/LICENSE-MIT) or http://opensource.org/licenses/MIT)\n  at your option.\n\n### Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally\nsubmitted for inclusion in the work by you, as defined in the\nApache-2.0 license, shall be dual licensed as above, without any\nadditional terms or conditions.\n\n[book-usage]: https://cuicui.nicopap.ch/usage.html\n[The cuicui Book]: https://cuicui.nicopap.ch/introduction.html\n[the chirpunk example]: https://github.com/nicopap/cuicui_layout/tree/main/examples/chirpunk\n[`cuicui_layout`]: https://cuicui.nicopap.ch/layout/index.html\n[`cuicui_chirp`]: https://cuicui.nicopap.ch/chirp/index.html\n[`cuicui_dsl`]: https://cuicui.nicopap.ch/dsl/index.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicopap%2Fcuicui_layout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicopap%2Fcuicui_layout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicopap%2Fcuicui_layout/lists"}