https://github.com/gaprogman/onionarch

A .NET Core demo application which uses the Onion Architecture
https://github.com/gaprogman/onionarch

Last synced: 11 months ago
JSON representation

A .NET Core demo application which uses the Onion Architecture

• Host: GitHub
• URL: https://github.com/gaprogman/onionarch
• Owner: GaProgMan
• License: mit
• Created: 2017-10-11T20:47:31.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-01-07T10:42:33.000Z (over 3 years ago)
• Last Synced: 2025-03-30T20:12:39.948Z (over 1 year ago)
• Language: C#
• Size: 1.39 MB
• Stars: 103
• Watchers: 11
• Forks: 36
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: Code-of-Conduct.md

Awesome Lists containing this project

README

          
# OnionArch

A .NET Core demo application which uses the Onion Architecture

## Licence Used

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

See the contents of the LICENSE file for details

## Support This Project

If you have found this project helpful, either as a library that you use or as a learning tool, please consider buying me a coffee:



## Pull Requests

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

Pull requests are welcome, but please take a moment to read the Code of Conduct before submitting them or commenting on any work in this repo.

## Code of Conduct

OnionArch has a Code of Conduct which all contributors, maintainers and forkers must adhere to. When contributing, maintaining, forking or in any other way changing the code presented in this repository, all users must agree to this Code of Conduct.

See [Code of Conduct.md](Code-of-Conduct.md) for details.

## Installing the Template

To use the template locally, it will need to be installed. You can do this from either the NuGet package (see the next section) or by installing it from source. To install from source, please seen the [NuGetReadMe.md](NuGetReadme) file for instructions.

## NuGet Package

This project is now available as a [NuGet package](https://www.nuget.org/packages/OnionArch.Mvc)

## Running The Application

1. Ensure that the `appsettings.json` file contains a valid `ConnectionStrings` section.

You will need two connection strings:

* onionDataConnection

This is the database which will contain all of the Book and Series information

* onionAuthConnection

This is the database which will contain all of the ASP.NET MVC Core auth information.

Example ConnectionStrings section:

    "ConnectionStrings": {

      "onionDataConnection": "DataSource=onionData.db",

      "onionAuthConnection": "DataSource=onionAuth.db"

    },

2. Open a command prompt in the `Onion.Web` directory

Issue the following commands to set up the databases:

    dotnet restore

Check for migrations in the `Onion.Repo.Identity` directory. If there isn't a directory labelled `Migrations`, then run the following (from the `Onion.Web`) directory to generate them:

    dotnet ef migrations add CreateIdentitySchema -c AppIdentityDbContext -p ../Onion.Repo/Onion.Repo.csproj -s Onion.Web.csproj

Similarly, check for migrations in the `Onion.Repo.Data` directory. If there isn't a directory labelled `Migrations`, then run the following (from the `Onion.Web`) directory to generate them:

    dotnet ef migrations add InitialMigration -c DataContext -p ../Onion.Repo/Onion.Repo.csproj -s Onion.Web.csproj

Apply all migrations to the databases by running the following commands (from the `Onion.Web` directory):

    dotnet ef database update -c DataContext -p ../Onion.Repo/Onion.Repo.csproj -s Onion.Web.csproj

    dotnet ef database update -c AppIdentityDbContext -p ../Onion.Repo/Onion.Repo.csproj -s Onion.Web.csproj

3. Build the front end

Issue the following commands from the `Onion.Web` directory:

    npm i

    npm run build

4. Run the application and seed the database

Issue the following command from the `Onion.Web` directory:

    dotnet run