A .NET MVP Microservices Suite/Web API to get up and running building your prototype fast.
- Features
- Prerequisites
- Getting Started
- Obtaining API Keys for Stripe, Paypal and SendGrid API's
- Project Structure
- Dependencies
- FAQ
- How It Works
- Changelog
- Contributing
- License
- Local Authentication using Email and Password
- OAuth 1.0a Authentication via Twitter
- OAuth 2.0 Authentication via Facebook, Google, GitHub, LinkedIn, Instagram
- Flash notifications
- MVC Project Structure
- Bootstrap 3
- Contact Form (powered by Mailgun, Sendgrid or Mandrill)
- Account Management
- Gravatar
- Profile Details
- Change Password
- Forgot Password
- Reset Password
- Delete Account
- CSRF protection
- API Examples: Facebook, Foursquare, Last.fm, Tumblr, Twitter, Stripe, LinkedIn and more.
- Automatic Documentation
- Mysql or Postgresql
- PHP 5.4+
- Command Line Tools
- Mac OS X: Xcode (or OS X 10.9+:
xcode-select --install
) - Windows: Visual Studio
- Ubuntu / Linux Mint:
sudo apt-get install build-essential
- Fedora:
sudo dnf groupinstall "Development Tools"
- OpenSUSE:
sudo zypper install --type pattern devel_basis
- Optic:
npm install -g @useoptic/cli
(needed for automatic documentation)
Note:
# Get the project
git clone https://github.com/propenster/dotnet-mvp-webapi-starter.git
# Change directory
cd dotnet-mvp-webapi-starter/DotNetWebAPIMVPStarter
# Update your config values e.g connection strings,apiKeys etc in appsettings.json
# Create a database (SQLServer)
# And update apappsettings.json with its connection string.
# Run Migrations at the Package Manager Console
Add-Migration initialMigration
# Update Database
Update-Database
# Build and Run the API for the first time.
dotnet run
This starter pack includes the following APIs. You will need to obtain appropriate credentials like Client ID, zClient secret, API key, or Username & Password by going through each provider and generate new credentials.
- Cloudder
- Twillo
- Github
- Slack
- Socialite Providers
- Socialite LinkedIn
- Sign up or log into your dashboard
- Click on your profile and click on Account Settings
- Then click on API Keys
- Copy the Secret Key. and add this into
.env
file
- Visit PayPal Developer
- Log in to your PayPal account
- Click Applications > Create App in the navigation bar
- Enter Application Name, then click Create app
- Copy and paste Client ID and Secret keys into
.env
file - App ID is client_id, App Secret is client_secret
- Change host to api.paypal.com if you want to test against production and use the live credentials
- Go to https://sendgrid.com/user/signup
- Sign up and confirm your account via the activation email
- Then enter your SendGrid Username and Password into
.env
file
- Go to https://www.twilio.com/try-twilio
- Sign up for an account.
- Once logged into the dashboard, expand the link 'show api credentials'
- Copy your Account Sid and Auth Token
Name | Description |
---|
Package | Description |
---|---|
socialite | Sign-in with Facebook, Twitter and Github |
socialite providers | Sign-in with LinkedIn, Instagram |
cloudder | Upload images to Cloudinary |
Thank you for considering contributing to the project. Kindly create an issue and a new branch like so features/name-of-my-branch for a new feature and bugfixes/name-of-my-branch and also include a test with your code to ensure all is still good. The contribution guide can be found in the Contribution File
If you discover a security vulnerability within Laravel Hackathon Starter, please send an e-mail to Prosper Otemuyiwa at [email protected]. All security vulnerabilities will be promptly addressed.
Why not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or HackerNews? Spread the word!
Don't forget to follow me on twitter!
Thanks! Faith Olusegun - propenster.
The MIT License (MIT). Please see License File for more information.