{"id":25311482,"url":"https://github.com/xapier14/cerulean","last_synced_at":"2025-10-28T15:30:41.129Z","repository":{"id":37897520,"uuid":"501747364","full_name":"Xapier14/Cerulean","owner":"Xapier14","description":"A cross-platform UI framework for C#.","archived":false,"fork":false,"pushed_at":"2022-12-30T14:48:33.000Z","size":4290,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-30T00:03:38.674Z","etag":null,"topics":["c-sharp","dotnet","gui","sdl2","xml"],"latest_commit_sha":null,"homepage":"","language":"C#","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/Xapier14.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-09T17:26:02.000Z","updated_at":"2024-01-05T06:36:54.000Z","dependencies_parsed_at":"2023-01-31T11:46:07.294Z","dependency_job_id":null,"html_url":"https://github.com/Xapier14/Cerulean","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xapier14%2FCerulean","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xapier14%2FCerulean/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xapier14%2FCerulean/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xapier14%2FCerulean/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xapier14","download_url":"https://codeload.github.com/Xapier14/Cerulean/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238669651,"owners_count":19510763,"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":["c-sharp","dotnet","gui","sdl2","xml"],"created_at":"2025-02-13T14:25:05.347Z","updated_at":"2025-10-28T15:30:40.756Z","avatar_url":"https://github.com/Xapier14.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eCerulean UI\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eUseful Tools\u003c/b\u003e\u003cbr\u003e\n  \u003ca href=\"#\"\u003eCLI Tool\u003c/a\u003e | \n  \u003ca href=\"#\"\u003eLayout Designer\u003c/a\u003e\n\u003c/p\u003e\n\u003ch4\u003eAvailable on Nuget\u003c/h4\u003e\n\n![Nuget](https://img.shields.io/nuget/v/Cerulean.Core?label=Cerulean.Core) ![Nuget](https://img.shields.io/nuget/v/Cerulean.Common?label=Cerulean.Common) ![Nuget](https://img.shields.io/nuget/v/Cerulean.Components?label=Cerulean.Components) ![Nuget](https://img.shields.io/nuget/v/Cerulean.CLI?label=Cerulean.CLI)\n\n\u003ch2\u003eBasic Information\u003c/h2\u003e\nWrite \u003cstrong\u003ecross-platform\u003c/strong\u003e GUI apps using simple XML and C#.\u003cbr\u003e\nMainly testing on Windows and Ubuntu. Feel free to test on other platforms.\u003cbr\u003e\n\u003cbr\u003e\nCheck out this \u003ca href=\"https://github.com/Xapier14/Calculator\"\u003esample calculator app on CeruleanUI\u003c/a\u003e.\u003cbr\u003e\n\u003cbr\u003e\nShould also work on OSX, but you need to install SDL2 and the other libraries to your frameworks folder.\u003cbr\u003e\nBundle your needed fonts in a folder called \"Fonts\" in the build directory as the font loader is jank with OSX.\n\n\u003ch2\u003eGetting Started\u003c/h2\u003e\n\n\u003e **Warning**\n\u003e This section is heavily under-construction. Use a release build instead if available.\n\n1. Download a release build [here](https://github.com/Xapier14/Cerulean/releases) and extract the archive.\n2. Add the `crn` executable to your binaries folder or add the containing folder to the `%PATH%` environment variable.\n3. Create your new app via:\n    ```bash\n    crn new \u003capp_name\u003e\n    ```\n4. Build the project.\n    ```bash\n    crn build\n    ```\n    This should automatically build the XMLs, the dotnet project, and bundle the needed dependencies.\n    \n    Currently, the bundler only works on a Windows build target for now. Support for other operating systems will come in a later update.\n    \n    See \"Important Notes\" below on how to bundle and install dependencies for other OSs.\n5. Run the app via:\n    ```bash\n    crn run\n    ```\n    If you run into DllNotFound errors, try running `crn bundle`.\n\n\u003ch2\u003eImportant Notes\u003c/h2\u003e\n\n - .NET 6 is **required** for the CLI tool.\n - .NET 6 or newer projects are compatible with CeruleanUI.\n - By default, the CLI should use the latest .NET SDK and creates a project with the same version.\n - Use the appropriate SDL2 binaries for your app/system.\n    - On Any CPU, use the binaries appropriate for your system's architecture.\n    - On x86, use x86.\n    - On x64, use x64.\n - On Windows, use the runtime binaries available at \u003ca href=\"https://libsdl.org/\"\u003elibsdl.org\u003c/a\u003e.\n - On Ubuntu, simply do:\n    ```bash\n    sudo apt-get install libsdl2-dev\n    sudo apt-get install libsdl2-ttf-dev\n    sudo apt-get install libsdl2-image-dev\n    ```\n    - **NOTE:** the snap version of `dotnet` will NOT find the SDL2 library. Please install dotnet with APT.\n        - See \u003ca href=\"https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu\"\u003einstalling dotnet\u003c/a\u003e on MSDN.\n        - Relevant issue: \u003ca href=\"https://github.com/exelix11/SysDVR/issues/118\"\u003eexelix11/SysDVR (#118)\u003c/a\u003e.\n - Fonts will be searched first in a folder called `Fonts` in the environment's current directory, and then the system's font directory.\n    - The default font for the Label component is `Arial` (*Subject to change*).\n    - The library will find the first font with a filename of `Arial.ttf` or `Arial.otf`, this is case-insensitive.\n    - If not found, it will simply throw a `GeneralAPIException: \"Font not found.\"`.\n\u003ch2\u003eFeatures\u003c/h2\u003e\n\n### Cerulean API\n - [x] Window Events\n - [x] Styler Element\n### Cerulean Components\n - [x] Functional Components\n     - [x] Timer\n     - [x] Pointer\n - [ ] Dialog Components\n     - [ ] Message Box\n     - [ ] Open File Dialog\n     - [ ] Save File Dialog\n     - [ ] Folder Select Dialog\n - [x] Graphical Components\n     - [x] Rectangle\n     - [x] Image\n     - [x] Progress Bar\n     - [x] Label\n - [ ] Input Components\n     - [x] TextBox\n     - [ ] MultiTextBox\n     - [x] Button\n     - [x] Check Box\n     - [x] Radio Button\n     - [ ] Drop Down List\n - [ ] Container Components\n     - [x] Grid\n     - [x] Panel\n     - [ ] Stack Panel\n     - [ ] Group Tab\n### Cerulean CLI\n - [x] Style Builder\n - [ ] C# Snippet Element\n - [x] Project Builder/Scaffolder\n \n \n## Warning\nThis is a WIP project, please do not use in commercial projects.\n\n## License\n\nThis project uses the MIT License.\nSDL2 and SDL2-CS, dependencies of this project, are released under the zlib license.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxapier14%2Fcerulean","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxapier14%2Fcerulean","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxapier14%2Fcerulean/lists"}