Skip to content

README.md

Latest commit

 

History

History
59 lines (38 loc) · 1.25 KB

README.md

File metadata and controls

59 lines (38 loc) · 1.25 KB

auth-auth

Small authentication/profile system for Codebar.

Local Setup

For login or registration via GitHub to work, you have create an oauth2 application. Fetch client id and secret and setup the .envrc from included example (in .envrc-dist).

Then export GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET into the environment. We recommend using direnv.

For a new run the following:

npm ci
npm run db:generate
npm run db:migrate
npm run dev

To update your local copy:

npm ci
npm run db:migrate
npm run dev

View the application:

open http://localhost:3000

Context

  • data is saved in a sqlite database
  • the app currently supports username/password, magic-link and GitHub OAuth
  • for magic-link, inspect the log to fetch the URL

What's happening here?

Once the application is running, you can try out the the following flows:

  • sign-up
  • sign-in (username/password, GitHub OAuth, magic-link)

In addition /admin hosts a very basic admin ui (list user, update roles).

Demo

There's an additional application (mounted in this setup), that would demonstrate how to determine if a user is logged in.

open http://localhost:3000/demo