{"id":20822322,"url":"https://github.com/radekvym/simpletoolkit","last_synced_at":"2025-05-16T09:03:57.048Z","repository":{"id":64971882,"uuid":"520095756","full_name":"RadekVyM/SimpleToolkit","owner":"RadekVyM","description":".NET MAUI library of helpers and simple, fully customizable controls, such as SimpleShell – custom Shell implementation that allows you to create unique navigation experiences.","archived":false,"fork":false,"pushed_at":"2025-04-13T12:05:51.000Z","size":44906,"stargazers_count":501,"open_issues_count":10,"forks_count":53,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-05-16T09:03:48.909Z","etag":null,"topics":["android","component-library","components","controls","dotnet","dotnet-core","ios","library","maccatalyst","maui","maui-apps","mobile-development","mobile-library","navigation-component","simpletoolkit","windows"],"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/RadekVyM.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,"zenodo":null}},"created_at":"2022-08-01T12:11:50.000Z","updated_at":"2025-05-15T05:14:04.000Z","dependencies_parsed_at":"2024-01-30T23:50:36.431Z","dependency_job_id":"98c60a94-8484-4514-b838-5a1fe6a8f6a2","html_url":"https://github.com/RadekVyM/SimpleToolkit","commit_stats":{"total_commits":94,"total_committers":3,"mean_commits":"31.333333333333332","dds":0.08510638297872342,"last_synced_commit":"3d195eb39529bad252a1d35d79ed907205adc6a0"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RadekVyM%2FSimpleToolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RadekVyM%2FSimpleToolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RadekVyM%2FSimpleToolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RadekVyM%2FSimpleToolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RadekVyM","download_url":"https://codeload.github.com/RadekVyM/SimpleToolkit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254501556,"owners_count":22081528,"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":["android","component-library","components","controls","dotnet","dotnet-core","ios","library","maccatalyst","maui","maui-apps","mobile-development","mobile-library","navigation-component","simpletoolkit","windows"],"created_at":"2024-11-17T22:14:37.648Z","updated_at":"2025-05-16T09:03:56.992Z","avatar_url":"https://github.com/RadekVyM.png","language":"C#","readme":"# \u003cimg src=\"./images/logo_with_background.svg\" width=\"40\" height=\"25\"\u003e SimpleToolkit\n\nSimpleToolkit is a .NET MAUI library of helpers and simple, easily customizable controls.\n\nThe library consists of these NuGet packages:\n\n- [SimpleToolkit.Core](#simpletoolkitcore) - set of simple .NET MAUI controls and helpers\n\n  [![NuGet](https://img.shields.io/nuget/v/SimpleToolkit.Core.svg?label=SimpleToolkit.Core)](https://www.nuget.org/packages/SimpleToolkit.Core/)\n\n- [SimpleToolkit.SimpleShell](#simpletoolkitsimpleshell) - simplified implementation of .NET MAUI `Shell`\n\n  [![NuGet](https://img.shields.io/nuget/v/SimpleToolkit.SimpleShell.svg?label=SimpleToolkit.SimpleShell)](https://www.nuget.org/packages/SimpleToolkit.SimpleShell/)\n\nI have split the content of this library into multiple NuGet packages because there may be people who want to use only the `SimpleShell` control, for example, and do not want to use other controls.\n\n\u003e [!CAUTION]\n\u003e Long-term support is not guaranteed. However, this repository is released under the MIT license, so you can always fork the repository and build the packages yourself.\n\n## [Samples](./docs/Samples.md)\n\nHere are some of my samples that were built using this library:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/MarvelousMAUI/main/images/android_illustrations_20.gif\" width=\"230\" /\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/MarvelousMAUI/main/images/iphone_wonders_transitions_20.gif\" width=\"239\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/RadekVyM/MarvelousMAUI\"\u003e\u003cem\u003eMarvelous .NET MAUI\u003c/em\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/Gadgets-Store-App/main/samples/android_gadgets_store_app.webp\" width=\"234\" /\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/Bet-App/main/Images/ios_betapp.webp\" width=\"236\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/RadekVyM/Gadgets-Store-App\"\u003e\u003cem\u003eGadget Store App\u003c/em\u003e\u003c/a\u003e\n    \u0026nbsp;|\u0026nbsp;\n    \u003ca href=\"https://github.com/RadekVyM/Bet-App\"\u003e\u003cem\u003eBet App\u003c/em\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/Navbar-Animation-1/main/Images/android_navbaranimation1.webp\" width=\"230\" /\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/Navbar-Animation-2/main/images/iphone_navbaranimation_2.webp\" width=\"236\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/RadekVyM/Navbar-Animation-1\"\u003e\u003cem\u003eNavbar Animation #1\u003c/em\u003e\u003c/a\u003e\n    \u0026nbsp;|\u0026nbsp;\n    \u003ca href=\"https://github.com/RadekVyM/Navbar-Animation-2\"\u003e\u003cem\u003eNavbar Animation #2\u003c/em\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/HamburgerMenuApp/main/images/android.gif\" width=\"230\" /\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg src=\"https://raw.githubusercontent.com/RadekVyM/Waste-App/main/Images/ios_wasteapp.webp\" width=\"236\" /\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/RadekVyM/HamburgerMenuApp\"\u003e\u003cem\u003eHamburger Menu App\u003c/em\u003e\u003c/a\u003e\n    \u0026nbsp;|\u0026nbsp;\n    \u003ca href=\"https://github.com/RadekVyM/Waste-App\"\u003e\u003cem\u003eWaste App\u003c/em\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e [!TIP]\n\u003e Check out a list of all samples [here](./docs/Samples.md).\n\n## Supported platforms\n\nThis library is built for the following platforms:\n\n- Android\n- iOS/Mac Catalyst\n- Windows (WinUI)\n\n## SimpleToolkit.Core\n\n[![SimpleToolkit.Core](https://img.shields.io/nuget/v/SimpleToolkit.Core.svg?label=SimpleToolkit.Core)](https://www.nuget.org/packages/SimpleToolkit.Core/)\n[![Documentation](https://img.shields.io/badge/-Documentation%20-forestgreen)](./docs/SimpleToolkit.Core)\n\nThe _SimpleToolkit.Core_ package is a set of simple .NET MAUI controls and helpers.\n\nThese are all the controls this package has to offer:\n\n- [Icon](./docs/SimpleToolkit.Core/Icon.md) - control that allows you to display a tinted image\n- [ContentButton](./docs/SimpleToolkit.Core/ContentButton.md) - button that can hold whatever content you want\n- [Popover](./docs/SimpleToolkit.Core/Popover.md) - control that allows you to display custom popovers (flyouts) anchored to any control\n\nIn order to use the controls listed above, you need to call the `UseSimpleToolkit()` extension method in your `MauiProgram.cs` file:\n\n```csharp\nbuilder.UseSimpleToolkit();\n```\n\nThis package also contains some useful helpers. For example, there are helpers that allow you to force application content to be displayed behind the system bars (status and navigation bars) on Android and iOS.\n\nSee [documentation](./docs/SimpleToolkit.Core) for more information.\n\n## SimpleToolkit.SimpleShell\n\n[![SimpleToolkit.SimpleShell](https://img.shields.io/nuget/v/SimpleToolkit.SimpleShell.svg?label=SimpleToolkit.SimpleShell)](https://www.nuget.org/packages/SimpleToolkit.SimpleShell/)\n[![Documentation](https://img.shields.io/badge/-Documentation%20-forestgreen)](./docs/SimpleToolkit.SimpleShell)\n\nThe _SimpleToolkit.SimpleShell_ package provides you with a simplified implementation of .NET MAUI `Shell` that lets you easily create a custom navigation experience in your .NET MAUI applications. The implementation is simply called `SimpleShell`.\n\nAll `SimpleShell` is is just a set of containers for your application content with the ability to put the hosting area for pages wherever you want. This gives you the **flexibility** to add custom tab bars, navigation bars, flyouts, etc. to your `Shell` application.\n\nBear in mind that **`SimpleShell` does not come with any navigation controls.** `SimpleShell` just gives you the ability to use custom navigation controls along with the URI-based navigation and automatic navigation stack management.\n\n\u003e [!IMPORTANT]\n\u003e Before you begin using `SimpleShell`, I highly recommend familiarizing yourself with the original .NET MAUI `Shell` - especially with the URI-based [navigation](https://learn.microsoft.com/en-us/dotnet/maui/fundamentals/shell/navigation), which works exactly the same as in `SimpleShell`. The `SimpleShell` class inherits from the `Shell` class.\n\nIn order to use `SimpleShell`, you need to call the `UseSimpleShell()` extension method in your `MauiProgram.cs` file:\n\n```csharp\nbuilder.UseSimpleShell();\n```\n\n### Why not use `SimpleShell` and use .NET MAUI `Shell` instead\n\n- .NET MAUI `Shell` offers a platform-specific appearance.\n- Platform-specific navigation controls that .NET MAUI `Shell` provides probably have better performance than controls composed of multiple .NET MAUI views.\n- A `SimpleShell`-based application may not have as good accessibility in some scenarios due to the lack of platform-specific navigation controls. .NET MAUI `Shell` should be accessible out of the box since it uses platform-specific controls.\n- Maybe I have implemented something wrong that has a negative impact on the performance, stability, accessibility, or something like that.\n\nSee [documentation](./docs/SimpleToolkit.SimpleShell) for more information.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradekvym%2Fsimpletoolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradekvym%2Fsimpletoolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradekvym%2Fsimpletoolkit/lists"}