# who
**Repository Path**: mirrors_dwyl/who
## Basic Information
- **Project Name**: who
- **Description**: 👥 the people in the dwyl org.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-01-17
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# *Who*? 🦄
The **quick _answer_**
to the question:
**_Who_ is in the `@dwyl` community?**
[](https://github.com/dwyl/who/actions/workflows/ci.yml)
[](http://codecov.io/github/dwyl/who?branch=main)
[](https://hex.pm/packages/elixir_auth_google)
[](https://github.com/dwyl/who/issues)
[](https://hits.dwyl.com/dwyl/app-who)
# **`TODO`**: re-generate the "wall of faces" using latest data `#HelpWanted`
# *Why*?
We needed an **easy, fast & reliable _system_**
to **_visualize_ `who`** is joining
the **`@dwyl` community**
and **track growth** over time. 📈
The [**start-here** > ***who***](https://github.com/dwyl/start-here/tree/8bbd28d2ab0c3b5a2a266a1e41fd160fc6ee3038#who)
section ~~is~~ _was_ *woefully* out of date
because we had to update it _manually_. ⏳
(_this was
[noted](https://github.com/dwyl/start-here/issues/9)
a `while` back...
but sadly was not made
a priority at the time..._)
This mini-app/project is designed
to scratch our own itch
and save us
[time](https://github.com/dwyl/start-here/issues/255).
# *What*?
There are **_two_ ways**
of discovering
the list of people
contributing to the
**dwyl mission**;
## 1. _Manually_ check *dwyl* Org *People Page* on GitHub
Visit
[github.com/orgs/dwyl/people](https://github.com/orgs/dwyl/people)
you can see a list of people
who are _members_ of the Org.
*Simple. effective. incomplete*.
This list only scratches the surface!
## 2. List all contributors to dwyl repos on `GitHub`
Read the Commit History for all the dwyl repos on GitHub
and extract the names of people ...
As you can imagine,
this second option
is _painful_ to do _manually_ ... ⏳
So we _had_ to create a mini-App
to do it for us
via the **`GitHub` API**! 💡
# *How*?
We built this mini-App
using the
[**`PETAL`** Stack](https://github.com/dwyl/technology-stack/#the-petal-stack)
because we feel
it's the _fastest_
and most _effective_ way
to ship a web app.
## Build Log 👷♀️
If you want to **understand _every_ step**
of the process of **_building_** the **mini-app**,
read:
[**`BUILDIT.md`**](https://github.com/dwyl/who/blob/main/BUILDIT.md)
## Run the `Who` App on your `localhost` ⬇️
> **Note**: You will need to have
**`Elixir`** and **`Postgres` installed**,
see:
[learn-elixir#installation](https://github.com/dwyl/learn-elixir#installation)
and
[learn-postgresql#installation](https://github.com/dwyl/learn-postgresql#installation)
> respectively.
> **Tip**: check the prerequisites in:
> [**/phoenix-chat-example**](https://github.com/dwyl/phoenix-chat-example#0-pre-requisites-before-you-start)
On your `localhost`,
run the following commands
in your terminal:
```sh
git clone git@github.com:dwyl/who.git && cd who
mix setup
```
That will download the **`code`**,
install dependencies
and create the necessary database + tables.
_Next_ you need to do **`1 minute`** of setup. ⏱️
### Create `.env` file
Create an `.env` file by copying the sample:
```sh
cp .env_sample .env
```
This file will load the
[environment variables](https://github.com/dwyl/learn-environment-variables)
required to run the App.
### Get your `GitHub` Personal Access Token
To access the **`GitHub` API**,
you will need to generate a
**Personal Access Token**:
[github.com/settings/tokens](https://github.com/settings/tokens/new)
Click on the **`Generate new token`** button.
Name it something memorable so you know what the token is for:
and make sure the token will have both `repo`
and `user` access:
Once you've created the token,
copy it to your clipboard for the next step.
### Add your `GitHub` token to the `.env` file
Add your token after the `=` sign:
```sh
export GH_PERSONAL_ACCESS_TOKEN=
```
Once you've saved your `.env` file,
run:
```sh
source .env
```
Once you have sourced your `.env` file,
you can run the app with:
```sh
mix s
```
Open the App in your web browser
[**`localhost:4000`**](http://localhost:4000/)
and start your tour!
## Contributing 👩💻
All contributions
from typo fixes
to feature requests
are always welcome! 🙌
Please start by:
a. **Star** the repo on GitHub
so you have a "bookmark" you can return to. ⭐
b. **Fork** the repo
so you have a copy you can "hack" on. 🍴
c. **Clone** the repo to your `localhost`
and run it! 👩💻
For more detail on contributing,
please see:
[dwyl/**contributing**](https://github.com/dwyl/contributing)
### More Features? 🔔
If you have feature ideas, that's great! 🎉
Please _share_:
[**who/issues**](https://github.com/dwyl/who/issues) 🙏
# Features (Todo)
+ List Repos in the Org:
https://docs.github.com/en/rest/repos/repos?apiVersion=2022-11-28#list-organization-repositories
+ List of people that Star a given repo.
+ List of people who have _contributed_ to repo.