Skip to content

Latest commit

 

History

History
112 lines (82 loc) · 5.84 KB

README.md

File metadata and controls

112 lines (82 loc) · 5.84 KB

QuickApp - ASPNET Core / Angular5 startup project template

MIT license

A startup Angular5 / ASP.NET Core (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

For the older asp.net core 1.x version: Download

live demo / downloadable demo

QuickApp Demo

This application consists of:

  • Template pages using Angular5 and TypeScript
  • RESTful API Backend using ASP.NET Core MVC Web API
  • Database using Entity Framework Core
  • Authentication based on OpenID Connect
  • API Documentation using Swagger
  • Webpack3 for managing client-side libraries
  • Theming using Bootstrap

You get the benefits of:

  • 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 Quidance
  • Angular Pipes Quidance
  • Angular Animations Quidance
  • Angular Services
  • Dialog and Notification Services
  • Configuration Page and Configuration Service
  • Integrated Internationaliztion
  • 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)
  • [OPTION 3] Yeoman generator package coming soon...

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 open an issue on github and I'll help fix it.

  • You can also get a personal trainer on the technologies used in this template for 100USD/Month. Email [email protected]

Login

LOGIN WITH USERNAME OR EMAIL ADDRESS

  • Default Administrator Account
  • Default Standard Account

Documentation

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!