{"id":31585330,"url":"https://github.com/nuvtools/nuvtools-aspnetcore","last_synced_at":"2026-03-03T19:32:05.245Z","repository":{"id":87912676,"uuid":"606976064","full_name":"nuvtools/nuvtools-aspnetcore","owner":"nuvtools","description":"A suite of helper libraries designed to simplify and enhance ASP.NET Core application development.","archived":false,"fork":false,"pushed_at":"2026-01-28T22:05:58.000Z","size":71,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T13:23:24.103Z","etag":null,"topics":["asp-net-core","blazor","blazor-webassembly","entity-framework-core","fluentvalidation","mudblazor","webutil"],"latest_commit_sha":null,"homepage":"https://nuvtools.com","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/nuvtools.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-27T03:31:35.000Z","updated_at":"2026-01-28T22:06:05.000Z","dependencies_parsed_at":"2025-11-20T22:03:09.605Z","dependency_job_id":null,"html_url":"https://github.com/nuvtools/nuvtools-aspnetcore","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/nuvtools/nuvtools-aspnetcore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuvtools%2Fnuvtools-aspnetcore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuvtools%2Fnuvtools-aspnetcore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuvtools%2Fnuvtools-aspnetcore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuvtools%2Fnuvtools-aspnetcore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuvtools","download_url":"https://codeload.github.com/nuvtools/nuvtools-aspnetcore/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuvtools%2Fnuvtools-aspnetcore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30056067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["asp-net-core","blazor","blazor-webassembly","entity-framework-core","fluentvalidation","mudblazor","webutil"],"created_at":"2025-10-06T01:47:13.244Z","updated_at":"2026-03-03T19:32:05.238Z","avatar_url":"https://github.com/nuvtools.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NuvTools ASP.NET Core Libraries\n\n[![NuGet](https://img.shields.io/nuget/v/NuvTools.AspNetCore.svg)](https://www.nuget.org/packages/NuvTools.AspNetCore/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nA suite of helper libraries designed to simplify and enhance ASP.NET Core application development. These libraries target modern .NET platforms, including .NET 8, .NET 9, and .NET 10.\n\n## Libraries\n\n### NuvTools.AspNetCore\n\nASP.NET Core helpers including composite localization.\n\n**Key Features:**\n- **Composite Localization**: Multi-source localization with prefix-based routing and fallback resolution\n- Fully documented with XML comments for IntelliSense support\n\n### NuvTools.AspNetCore.EntityFrameworkCore\n\nEntity Framework Core helpers for ASP.NET Core.\n\n**Key Features:**\n- **Database Migration Extensions**: Automatic migration application with configurable timeouts\n\n### NuvTools.AspNetCore.Blazor\n\nBlazor services for browser APIs and common functionality.\n\n**Key Features:**\n- **Clipboard Service**: Read/write clipboard operations\n- **Local Storage Service**: Browser localStorage with JSON serialization\n- **Session Storage Service**: Browser sessionStorage with JSON serialization\n- **Loading Service**: Counter-based loading indicator with nested call support and `RunAsync` helper\n\n### NuvTools.AspNetCore.Blazor.MudBlazor\n\nMudBlazor components and utilities for Blazor applications.\n\n**Key Features:**\n- **Pattern Converters**: Flexible input masking for MudTextField (phone, documents, etc.)\n- **Country-Specific Converters**: Pre-configured formatters for Brazil and United States\n- **MudTable Base Class**: Server-side paging with session storage persistence\n\n## Installation\n\nInstall via NuGet Package Manager:\n\n```bash\n# For general ASP.NET Core helpers\ndotnet add package NuvTools.AspNetCore\n\n# For Entity Framework Core helpers (includes NuvTools.AspNetCore)\ndotnet add package NuvTools.AspNetCore.EntityFrameworkCore\n\n# For Blazor JavaScript interop services\ndotnet add package NuvTools.AspNetCore.Blazor\n\n# For MudBlazor components and utilities\ndotnet add package NuvTools.AspNetCore.Blazor.MudBlazor\n```\n\nOr via Package Manager Console:\n\n```powershell\nInstall-Package NuvTools.AspNetCore\nInstall-Package NuvTools.AspNetCore.EntityFrameworkCore\nInstall-Package NuvTools.AspNetCore.Blazor\nInstall-Package NuvTools.AspNetCore.Blazor.MudBlazor\n```\n\n## Quick Start\n\n### Composite Localization\n\nSet up multiple localization sources with prefix-based routing:\n\n```csharp\n// In Program.cs or Startup.cs\nservices.AddCompositeLocalizer(\n    namedResourceTypes: new Dictionary\u003cstring, Type\u003e\n    {\n        [\"Errors\"] = typeof(ErrorResources),\n        [\"Messages\"] = typeof(MessageResources)\n    },\n    unnamedResourceTypes: new[] { typeof(SharedResources) }\n);\n\n// In your code\npublic class MyService\n{\n    private readonly CompositeLocalizer _localizer;\n\n    public MyService(CompositeLocalizer localizer)\n    {\n        _localizer = localizer;\n    }\n\n    public string GetMessage()\n    {\n        // Use prefix to target specific localizer\n        var error = _localizer[\"Errors:ValidationFailed\"];\n\n        // Or let it search all localizers\n        var message = _localizer[\"WelcomeMessage\"];\n\n        return message;\n    }\n}\n```\n\n### Database Migrations\n\nApply migrations automatically on startup:\n\n```csharp\n// In Program.cs\nvar app = builder.Build();\n\n// Apply migrations with default timeout\napp.DatabaseMigrate\u003cMyDbContext\u003e();\n\n// Or with custom timeout\napp.DatabaseMigrate\u003cMyDbContext\u003e(TimeSpan.FromMinutes(5));\n\napp.Run();\n```\n\n### Loading Service (Blazor)\n\nManage loading indicators with nested call support:\n\n```csharp\n// Register in Program.cs (or use services.AddBlazorServices() to register all)\nservices.AddLoadingService();\n\n// In your component\n@inject ILoadingService LoadingService\n@implements IDisposable\n\n\u003cMudOverlay Visible=\"LoadingService.IsLoading\" DarkBackground=\"true\"\u003e\n    \u003cMudProgressCircular Color=\"Color.Primary\" Indeterminate=\"true\" /\u003e\n\u003c/MudOverlay\u003e\n\n@code {\n    protected override void OnInitialized()\n    {\n        LoadingService.OnChange += StateHasChanged;\n    }\n\n    private async Task LoadData()\n    {\n        // Option 1: Manual Show/Hide (supports nesting)\n        LoadingService.Show();\n        try { await FetchData(); }\n        finally { LoadingService.Hide(); }\n\n        // Option 2: RunAsync helper (recommended)\n        await LoadingService.RunAsync(async () =\u003e await FetchData());\n    }\n\n    public void Dispose() =\u003e LoadingService.OnChange -= StateHasChanged;\n}\n```\n\n### Pattern Converters (MudBlazor)\n\nApply input masks to MudTextField components:\n\n```csharp\n@using NuvTools.AspNetCore.Blazor.MudBlazor.Converters\n\n// Custom pattern: A=alphanumeric, N=numeric, L=letter\n\u003cMudTextField @bind-Value=\"LicensePlate\"\n              Converter=\"@(new PatternStringConverter(\"LLL-NANN\"))\" /\u003e\n```\n\n### Country-Specific Converters\n\n**United States:**\n\n```csharp\n@using NuvTools.AspNetCore.Blazor.MudBlazor.UnitedStates.Converters\n\n\u003cMudTextField @bind-Value=\"Phone\" Label=\"Phone\"\n              Converter=\"USDocumentConverters.Phone\" /\u003e\n// Output: (555) 123-4567\n\n\u003cMudTextField @bind-Value=\"Ssn\" Label=\"SSN\"\n              Converter=\"USDocumentConverters.Ssn\" /\u003e\n// Output: 123-45-6789\n\n\u003cMudTextField @bind-Value=\"ZipCode\" Label=\"ZIP Code\"\n              Converter=\"USDocumentConverters.ZipCode\" /\u003e\n// Output: 90210\n\n// Format directly in code\nvar formatted = USDocumentConverters.FormatPhone(\"5551234567\");\n```\n\n**Brazil:**\n\n```csharp\n@using NuvTools.AspNetCore.Blazor.MudBlazor.Brazil.Converters\n\n\u003cMudTextField @bind-Value=\"MobilePhone\" Label=\"Mobile\"\n              Converter=\"BrazilianDocumentConverters.MobilePhone\" /\u003e\n// Output: (11) 99999-9999\n\n\u003cMudTextField @bind-Value=\"Cpf\" Label=\"CPF\"\n              Converter=\"BrazilianDocumentConverters.Cpf\" /\u003e\n// Output: 123.456.789-00\n\n// Auto-detect mobile vs landline\nvar formatted = BrazilianDocumentConverters.FormatPhone(\"11999999999\");\n```\n\n### Clipboard Service (Blazor)\n\nUse JavaScript interop for clipboard operations:\n\n```csharp\n@inject ClipboardService ClipboardService\n\n\u003cbutton @onclick=\"CopyToClipboard\"\u003eCopy\u003c/button\u003e\n\u003cbutton @onclick=\"PasteFromClipboard\"\u003ePaste\u003c/button\u003e\n\n@code {\n    private async Task CopyToClipboard()\n    {\n        await ClipboardService.WriteTextAsync(\"Hello, World!\");\n    }\n\n    private async Task PasteFromClipboard()\n    {\n        var text = await ClipboardService.ReadTextAsync();\n        Console.WriteLine(text);\n    }\n}\n```\n\n## Features\n\n- **Multi-targeting**: Compatible with .NET 8, .NET 9, and .NET 10\n- **Comprehensive documentation**: Full XML documentation for IntelliSense\n- **Modular design**: Use only what you need\n- **Best practices**: Promotes clean architecture patterns\n- **Modern C# features**: Uses nullable reference types, implicit usings, and primary constructors\n\n## Building from Source\n\nThis project uses the modern `.slnx` solution format (Visual Studio 2022 v17.11+).\n\n```bash\n# Clone the repository\ngit clone https://github.com/nuvtools/nuvtools-aspnetcore.git\ncd nuvtools-aspnetcore\n\n# Build the solution\ndotnet build NuvTools.AspNetCore.slnx\n\n# Run tests\ndotnet test NuvTools.AspNetCore.slnx\n\n# Create release packages\ndotnet build NuvTools.AspNetCore.slnx --configuration Release\n```\n\n## Requirements\n\n- .NET 8.0 SDK or higher\n- Visual Studio 2022 (v17.11+) or Visual Studio Code with C# extension\n- MudBlazor 8.0.0+ (for NuvTools.AspNetCore.Blazor.MudBlazor)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Links\n\n- [GitHub Repository](https://github.com/nuvtools/nuvtools-aspnetcore)\n- [NuGet Package - NuvTools.AspNetCore](https://www.nuget.org/packages/NuvTools.AspNetCore/)\n- [NuGet Package - NuvTools.AspNetCore.EntityFrameworkCore](https://www.nuget.org/packages/NuvTools.AspNetCore.EntityFrameworkCore/)\n- [NuGet Package - NuvTools.AspNetCore.Blazor](https://www.nuget.org/packages/NuvTools.AspNetCore.Blazor/)\n- [NuGet Package - NuvTools.AspNetCore.Blazor.MudBlazor](https://www.nuget.org/packages/NuvTools.AspNetCore.Blazor.MudBlazor/)\n- [Official Website](https://nuvtools.com)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuvtools%2Fnuvtools-aspnetcore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuvtools%2Fnuvtools-aspnetcore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuvtools%2Fnuvtools-aspnetcore/lists"}