Winsoft.GOV/Winsoft.GOV.XF.WebApi.ManagerCore/Winsoft.GOV.XF.WebApi.ManagerCore



QuickApp - ASPNET Core / Angular4 startup project template

A startup Angular4 / 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

This application consists of:

• Template pages using Angular4 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


• Webpack2 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.
  


• 
  If you're really new to this consider paid consultancy (I'll guide you on asp.net core through to angular4 and related technologies to quickly get you up to speed)
  

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


• Angular4 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


• Donate a dollar if you feel inspired

License

Released under the MIT License.

YOUR FEEDBACK
|
FOLLOW ME

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