{"id":15026560,"url":"https://github.com/nikolayit/asp.net-core-template","last_synced_at":"2025-05-15T05:02:21.903Z","repository":{"id":42632574,"uuid":"50858772","full_name":"NikolayIT/ASP.NET-Core-Template","owner":"NikolayIT","description":"A ready-to-use template for ASP.NET Core with repositories, services, models mapping, DI and StyleCop warnings fixed.","archived":false,"fork":false,"pushed_at":"2023-04-27T15:54:38.000Z","size":5734,"stargazers_count":1098,"open_issues_count":10,"forks_count":174,"subscribers_count":56,"default_branch":"master","last_synced_at":"2025-04-14T04:13:50.665Z","etag":null,"topics":["asp-net-core","asp-net-core-3-1","aspnet-core","aspnetcore","aspnetcoretemplate","template"],"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/NikolayIT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"NikolayIT","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2016-02-01T17:55:31.000Z","updated_at":"2025-04-12T20:15:45.000Z","dependencies_parsed_at":"2024-01-02T22:43:57.297Z","dependency_job_id":"7aed9126-60ea-4afc-8350-ad8f531f5022","html_url":"https://github.com/NikolayIT/ASP.NET-Core-Template","commit_stats":null,"previous_names":["nikolayit/asp.net-mvc-template"],"tags_count":8,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikolayIT%2FASP.NET-Core-Template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikolayIT%2FASP.NET-Core-Template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikolayIT%2FASP.NET-Core-Template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikolayIT%2FASP.NET-Core-Template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NikolayIT","download_url":"https://codeload.github.com/NikolayIT/ASP.NET-Core-Template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248819406,"owners_count":21166477,"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":["asp-net-core","asp-net-core-3-1","aspnet-core","aspnetcore","aspnetcoretemplate","template"],"created_at":"2024-09-24T20:04:41.752Z","updated_at":"2025-04-14T04:13:55.893Z","avatar_url":"https://github.com/NikolayIT.png","language":"C#","funding_links":["https://github.com/sponsors/NikolayIT"],"categories":[],"sub_categories":[],"readme":"# ASP.NET Core Template\n\nA ready-to-use template for ASP.NET Core with repositories, services, models mapping, DI and StyleCop warnings fixed.\n\n## Build status\n\n[![Build Status](https://nikolayit.visualstudio.com/AspNetCoreTemplate/_apis/build/status/NikolayIT.ASP.NET-Core-Template?branchName=master)](https://nikolayit.visualstudio.com/AspNetCoreTemplate/_build/latest?definitionId=15\u0026branchName=master)\n\n## Authors\n\n- [Nikolay Kostov](https://github.com/NikolayIT)\n- [Vladislav Karamfilov](https://github.com/vladislav-karamfilov)\n- [Stoyan Shopov](https://github.com/StoyanShopov)\n\n## Package Installation\n\nYou can install this template using [NuGet](https://www.nuget.org/packages/AspNetCoreTemplate):\n\n```powershell\ndotnet new -i AspNetCoreTemplate\n```\n\n```powershell\ndotnet new aspnet-core -n YourProjectName\n```\n\n## Pack this Template\n\n```powershell\ndotnet pack .\\nuget.csproj\n```\n\n## Project Overview\n\n![Dependencies Graph](https://user-images.githubusercontent.com/25417032/97107966-0e5fc500-16d3-11eb-9b9c-c73012ff97ac.png)\n![image](https://user-images.githubusercontent.com/25417032/97108063-9fcf3700-16d3-11eb-8225-32eac21c4542.png)\n\n### Common\n\n**AspNetCoreTemplate.Common** contains common things for the project solution. For example:\n\n- [GlobalConstants.cs](https://github.com/NikolayIT/ASP.NET-Core-Template/blob/master/src/AspNetCoreTemplate.Common/GlobalConstants.cs).\n\n### Data\n\nThis solution folder contains three subfolders:\n\n- AspNetCoreTemplate.Data.Common\n- AspNetCoreTemplate.Data.Models\n- AspNetCoreTemplate.Data\n\n#### AspNetCoreTemplate.Data.Common\n\n[AspNetCoreTemplate.Data.Common.Models](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Data/AspNetCoreTemplate.Data.Common/Models) provides abstract generics classes and interfaces, which holds information about our entities. For example when the object is Created, Modified, Deleted or IsDeleted. It contains a property for the primary key as well.\n\n[AspNetCoreTemplate.Data.Common.Repositories](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Data/AspNetCoreTemplate.Data.Common/Repositories) provides two interfaces IDeletableEntityRepository and IRepository, which are part of the **repository pattern**.\n\n#### AspNetCoreTemplate.Data.Models\n\n[AspNetCoreTemplate.Data.Models](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Data/AspNetCoreTemplate.Data.Models) contains ApplicationUser and ApplicationRole classes, which inherits IdentityRole and IdentityUsers.\n\n#### AspNetCoreTemplate.Data\n\n[AspNetCoreTemplate.Data](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Data/AspNetCoreTemplate.Data) contains DbContext, Migrations and Configuraitons for the EF Core.There is Seeding and Repository functionality as well.\n\n### Services\n\nThis solution folder contains four subfolders:\n\n- AspNetCoreTemplate.Services.Data\n- AspNetCoreTemplate.Services.Mapping\n- AspNetCoreTemplate.Services.Messaging\n- AspNetCoreTemplate.Services\n\n#### AspNetCoreTemplate.Services.Data\n\n[AspNetCoreTemplate.Services.Data](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Services/AspNetCoreTemplate.Services.Data) wil contains service layer logic.\n\n#### AspNetCoreTemplate.Services.Mapping\n\n[AspNetCoreTemplate.Services.Mapping](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Services/AspNetCoreTemplate.Services.Mapping) provides simplified functionlity for auto mapping. For example:\n\n```csharp\nusing Blog.Data.Models;\nusing Blog.Services.Mapping;\n\npublic class TagViewModel : IMapFrom\u003cTag\u003e\n{\n    public int Id { get; set; }\n\n    public string Name { get; set; }\n}\n```\n\nOr if you have something specific:\n\n```csharp\nusing System;\n\nusing AutoMapper;\nusing Blog.Data.Models;\nusing Blog.Services.Mapping;\n\npublic class IndexPostViewModel : IMapFrom\u003cPost\u003e, IHaveCustomMappings\n{\n    public int Id { get; set; }\n\n    public string Title { get; set; }\n\n    public string Author { get; set; }\n\n    public string ImageUrl { get; set; }\n\n    public DateTime CreatedOn { get; set; }\n\n    public void CreateMappings(IProfileExpression configuration)\n    {\n        configuration.CreateMap\u003cPost, IndexPostViewModel\u003e()\n            .ForMember(\n                source =\u003e source.Author,\n                destination =\u003e destination.MapFrom(member =\u003e member.ApplicationUser.UserName));\n    }\n}\n\n```\n\n#### AspNetCoreTemplate.Services.Messaging\n\n[AspNetCoreTemplate.Services.Messaging](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Services/AspNetCoreTemplate.Services.Messaging) a ready to use integration with [SendGrid](https://sendgrid.com/).\n\n#### AspNetCoreTemplate.Services\n\n[AspNetCoreTemplate.Services](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Services/AspNetCoreTemplate.Services)\n\n### Tests\n\nThis solution folder contains three subfolders:\n\n- AspNetCoreTemplate.Services.Data.Tests\n- AspNetCoreTemplate.Web.Tests\n- Sandbox\n\n#### AspNetCoreTemplate.Services.Data.Tests\n\n[AspNetCoreTemplate.Services.Data.Tests](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Tests/AspNetCoreTemplate.Services.Data.Tests) holds unit tests for our service layer with ready setted up xUnit.\n\n#### AspNetCoreTemplate.Web.Tests\n\n[AspNetCoreTemplate.Web.Tests](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Tests/AspNetCoreTemplate.Web.Tests) setted up Selenuim tests.\n\n#### Sandbox\n\n[Sandbox](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Tests/Sandbox) can be used to test your logic.\n\n### Web\n\nThis solution folder contains three subfolders:\n\n- AspNetCoreTemplate.Web.Infrastructure\n- AspNetCoreTemplate.Web.ViewModels\n- AspNetCoreTemplate.Web\n\n#### AspNetCoreTemplate.Web.Infrastructure\n\n[AspNetCoreTemplate.Web.Infrastructure](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Web/AspNetCoreTemplate.Web.Infrastructure) contains functionality like Middlewares and Filters.\n\n#### AspNetCoreTemplate.Web.ViewModels\n\n[AspNetCoreTemplate.Web.ViewModels](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Web/AspNetCoreTemplate.Web.ViewModels) contains objects, which will be mapped from/to our entities and used in the front-end/back-end.\n\n#### AspNetCoreTemplate.Web\n\n[AspNetCoreTemplate.Web](https://github.com/NikolayIT/ASP.NET-Core-Template/tree/master/src/Web/AspNetCoreTemplate.Web) self explanatory.\n\n## Support\n\nIf you are having problems, please let us know by [raising a new issue](https://github.com/NikolayIT/ASP.NET-Core-Template/issues).\n\n## Example Projects\n\n- \u003chttps://github.com/NikolayIT/PressCenters.com\u003e\n- \u003chttps://github.com/NikolayIT/nikolay.it\u003e\n\n## License\n\nThis project is licensed with the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikolayit%2Fasp.net-core-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikolayit%2Fasp.net-core-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikolayit%2Fasp.net-core-template/lists"}