An open API service indexing awesome lists of open source software.

https://github.com/codebar/auth

Auth for codebar (the project formerly known as auth-auth)
https://github.com/codebar/auth

Last synced: 21 days ago
JSON representation

Auth for codebar (the project formerly known as auth-auth)

Awesome Lists containing this project

README

          

# auth-auth

Small authentication/profile system for Codebar.

## Local Setup

For login or registration via GitHub to work, you have create an [oauth2 application](https://github.com/settings/developers). 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](https://direnv.net/).

---

For a new run the following:

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

To update your local copy:

```sh
npm ci
npm run db:migrate
npm run dev
```

---

View the application:

```sh
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.

```sh
open http://localhost:3000/demo
```