Hey there!

This repo is a vapor 3 (a swift web framework) app template with auth routes, and it's ready to be deployed to Heroku.

The main purpose of this is to serve me as a starting point for my apps and to inspire you to hack your own!
Or please feel free to just use this as a starting template for your apps!

You may also freely use any code from this repo without attribution.
If you want to reach out, please feel free to drop me a line here:

let account = ["true", "metal", "of", "steel"].joined(separator: ".")
let host = ["gmail", "com"].joined(separator: ".")
let res = [account, host].joined(separator: "@")

Cheers,
Dan
http://ios-engineer.com

Deployment demo

Features

• Heroku / postgres ready
• HTTPS only, HTTP requests are rejected with 403 forbidden
• Pre-populated with 4 user accounts - u1, u2, u3 and u4
• • passwod is 123 - same for all of them
• • comes with pre-populated access tokens - u1 token, u2 token, u3 token and u4 token

What's included

Public routes:

• GET /, /hello, /hello/name
• • hello routes for quick tests
• wss://host/ws
• • a websocket connection, will reverse and return whatever you send it

Auth routes:

• POST /register
• • send username and password as form-data
• POST /login
• • send credentials as HTTP basic auth
• POST /logout
• • auth protected, removes token

Token protected:

• GET /me
• • will return current username
• GET /users
• • will return list of all users (except for the one making the request)

Deploy steps

There's an option to use vapor toolbelt, but I prefer to do this manually:

• create heroku app and add postgres database to it
• git clone https://github.com/truemetal/vapor-heroku-auth-template.git to your mac
• git remote add heroku <your heroku app git url>
• heroku buildpacks:set https://github.com/vapor-community/heroku-buildpack.git
• git push heroku master

and to move it to your github / bitbucket

• git remote rm origin
• git remote add origin <your repo path>

macOS development

• Make sure to define DATABASE_URL
• • e.g. something this could go to your ~/.zshrc or ~/.bash_profile: export DATABASE_URL="postgresql://user@localhost:5432/database"
• Use vapor xcode -y or swift package generate-xcodeproj to create .xcodeproj and ./suppress-xcodeproj-warnings.rb to hide warnings from vapor frameworks

Contribution

Contributions are welcome! Please just open an issue or send a pull request.