Fatebook

The fastest way to make and track predictions.

This repo includes fatebook.io, Fatebook for Slack and Fatebook for Chrome.

You can report bugs in the Issues tab. You can make feature requests there or in our Discord.

Tech stack

• Prisma
• Next.js
• Vercel
• Slack API
• TRPC
• Tailwind

Contributing

If you're interested in contributing, let us know, and we can help you get up and running - thank you!

These following instructions assume you're using macOS and Homebrew.

Clone the repository

git clone https://github.com/Sage-Future/fatebook.git
cd fatebook
cp .env.example .env

Create TLS certificate for localhost

brew install mkcert
mkcert -install
mkcert localhost

Set up the database

brew install postgresql@15
# Or download and install from https://www.postgresql.org/download
# If you do this, follow the instructions there for starting the database.

# Follow the instructions that the installer provides on how to add postgresql@15 to your PATH.
# For example, on some systems it will tell you to do this:
echo 'export PATH="/opt/homebrew/opt/postgresql@15/bin:$PATH"' >> ~/.zshrc
. ~/.zshrc

# If you're using Bash rather than Z shell, substitute `~/.bash_profile` for
# `~/.zshrc` in the previous commands.

# Start postgres
LC_ALL="C" /opt/homebrew/opt/postgresql@15/bin/postgres -D /opt/homebrew/var/postgresql@15

Open a new terminal window and run the following commands:

# create `fatebook` role
createuser fatebook

# create `fatebook_development` database, owned by the `fatebook` user
createdb fatebook_development --owner fatebook

1. Run npm install to install dependencies.
2. Run npm run vercel-build to set up the Fatebook schema.

Start the server

1. Run npm run dev.
2. Go to https://localhost:3000. You should be able to sign in and create predictions.

Addendum

If you want to make or test changes to the Slack integration, you'll need to set up a Slack app. This is more involved - get in touch and we'll help you get up and running.

Optional extra step: Or set up your own Google OAuth credentials

Your .env.example is prefilled with the shared Fatebook developer Google OAuth credentials. If you'd like to create your own (e.g., to change the configuration), follow these steps:

1. Go to https://console.cloud.google.com/apis/credentials.
2. Click Configure a project. (Or, if you've previously made a project, click Your project -> New project -> Select your new project)
3. Click CREATE CREDENTIALS.
4. Select OAuth client ID.
5. You may need to follow the instructions in "Create consent screen" - select all non-sensitive scopes. Then try 3-4 again.
6. For Application type select Web application.
7. Under Name type something like Fatebook development.
8. Under Authorized redirect URIs, click ADD URI and under URIs 1 type https://localhost:3000/api/auth/callback/google.
9. Open the .env file in the root of the fatebook repository. Copy and paste the Client ID value after GOOGLE_CLIENT_ID= in fatebook/.env, and do the same for Client secret and GOOGLE_CLIENT_SECRET=.

If you have any problems, let us know!