QuickApp – ASP.NET Core 8 + Angular 17 startup project template

A startup Angular 17 / ASP.NET Core 8 (cross-platform ) project template with an end-to-end login, user and role management implementation. As well as other common functionalities for Quick Application Development.

FOLLOW ME on twitter for important updates

NOTE: Please post support related topics in the help & support forum. For bug reports open an issue on github.

LIVE DEMO

This application consists of:

• Template pages using Angular 17 and TypeScript
• RESTful API Backend using ASP.NET Core Web API
• Database using Entity Framework Core
• Authentication based on OIDC/OAuth2 and ASP.NET Core Identity
• API Documentation using Swagger
• Client-side built on Angular CLI
• Theming using Bootstrap 5

You get the benefits of:

• A simple, not “overengineered” startup project template for Quick Application Development
• A complete backend and frontend project structure to build on, with login, user and permission-based role management already integrated
• Data Access Layer built with the Repository and Unit of Work Pattern
• Code First Database
• A RESTful API Design
• Angular Directives Guidance
• Angular Pipes Guidance
• Angular Animations Guidance
• Angular Services
• Dialog and Notification Services
• Configuration Page and Configuration Service
• OIDC Service for quick integration of external OpenID providers
• Integrated Social logins such as Google, Facebook, Twitter
• Integrated Internationalization
• Theming with SASS
• Ready-to-use email API
• Handling Access and Refresh Tokens with WebStorage (Bearer authentication) – No Cookies
• jQuery Integration (Ability to use standard jQuery libraries)
• CRUD APIs

Installation

• [OPTION 1] Clone the Git Repository and edit with your favorite editor. e.g. Visual Studio, Visual Studio Code
• [OPTION 2] Install Project template from the Visual Studio Gallery and follow the usual File -> New Project -> Web -> QuickApp – to create a new Project from this template. Lunch with F5 or Ctrl+F5 (The usual way)

Installation Notes

• When creating a new project please wait for all dependencies (“dotnet restore” & “npm install”) to be restored.
  When using VisualStudio this is automatic, check the output window or status bar to know that the package/dependencies restore process is complete before launching your program for the first time.
• If you get this error: Unable to resolve ‘OpenIddict’, do the below steps to add myget.org to nuget package sources;
  Copy the “NuGet.config” from the project folder to the solution’s folder (i.e. copy to the same folder location as your solutions file) and restart your IDE
  OR
  Add myget.org to your package sources in VisualStudio.
  Visual Studio -> Tools -> Options -> NuGet Package Manager -> Package Sources, Add “aspnet-contrib”, this URL “https://www.myget.org/F/aspnet-contrib/api/v3/index.json“
• If you get any other errors, consider running manually the steps to build the project and note where the errors occur.
  Open command prompt and do the below steps:
  1. run ‘dotnet restore’ from the two project folders – Restore nuget packages
  2. run ‘npm install’ from the project with package.json – Restore npm packages
  3. run ‘npm run dev-build’ from the project with package.json – Build webpack vendor packages
  4. Try running the application again – Test to make sure it all works

  *When I say “run from the project folder” I mean run the commands on the command line from those folders
  If any step fails, post the error details on the support forum for the needed assistance.

• For help and support post in the support forum. For bug reports open an issue on github

Login

LOGIN WITH USERNAME OR EMAIL ADDRESS

• Default Administrator Account
  • Username: admin
  • Email: admin@ebenmonney.com
  • Password: tempP@ss123
• Default Standard Account
  • Username: user
  • Email: user@ebenmonney.com
  • Password: tempP@ss123

Documentation

• Overview of QuickApp
• Conceptual overview of what is ASP.NET Core
• Angular 17 documentation overview
• Working with Data
• An introduction to webpack

Contribution

QuickApp is actively maintained by Ebenezer Monney on GitHub. You can support it by

• Submitting your changes/improvements/features using pull requests
• Suggesting ideas or areas of improvements
• Encouraging the developers by rating it/starring it
• Linking to it and recommending it to others
• Making a donation

License

Released under the MIT License.

YOUR FEEDBACK | FOLLOW ME

If you found this template useful, please take a minute to rate it. Appreciated!