7e88a3b57f
* Update Travis's Slack config * Fix styling * Update prerequisites * Update prerequisites * Update README * Expand installation docs * Specify minimum Postgres version [ci skip] * Change specified PostgreSQL version * Update netlify.toml * Update schema * Update algolia links [ci skip] * Update installation docs * Remove TODO * Update installation path/title * Update top level installation guide * Change installations directory name * Rename installations to installation in docs * Fix headline typo * Add liquid tags and adjust main readme
140 lines
6.7 KiB
Markdown
140 lines
6.7 KiB
Markdown
There are a few services you'll need **_(all free)_** in order to run the development server and access the app locally. Here are the instructions for getting them:
|
|
|
|
# Algolia
|
|
|
|
Choose OAuth or Email Sign Up
|
|
|
|
## Algolia: OAuth Sign Up
|
|
|
|
1. [Click this link and sign up for an account with either GitHub or Google.](https://www.algolia.com/users/sign_up)
|
|
|
|
2. Select your region, and then hit "Let's get started!"
|
|
|
|
3. Skip the tutorial (or don't) and go to your dashboard.
|
|
|
|
4. Click "Go to your dashboard".
|
|
|
|
|
|
|
|
5. Agree to Terms and Conditions.
|
|
|
|
|
|
6. Click "API Keys" on the left navbar.
|
|
|
|
|
|
|
|
7. Change your keys accordingly (name of Algolia key -> name of our application key):
|
|
|
|
* `Application ID -> ALGOLIASEARCH_APPLICATION_ID`
|
|
* `Search-Only API Key -> ALGOLIASEARCH_SEARCH_ONLY_KEY`
|
|
* `Admin API KEY -> ALGOLIASEARCH_API_KEY`
|
|
|
|
|
|
|
|
8. Done!
|
|
|
|
---
|
|
|
|
---
|
|
|
|
---
|
|
|
|
## Algolia Email Sign Up
|
|
|
|
1. [Click this link and sign up for an account with your email address.](https://www.algolia.com/users/sign_up)
|
|
|
|
|
|
2. Fill out your name and what describes you the most.
|
|
|
|
|
|
3. Choose your datacenter/region closest to you.
|
|
|
|
|
|
4. Skip the step asking about your project.
|
|
|
|
|
|
5. Complete the onboarding flow and click "Go to dashboard".
|
|
|
|
|
|
6. Click "API Keys" on the left navbar.
|
|
|
|
|
|
|
|
7. Change your keys accordingly (name of Algolia key -> name of our application key):
|
|
|
|
* `Application ID -> ALGOLIASEARCH_APPLICATION_ID`
|
|
* `Search-Only API Key -> ALGOLIASEARCH_SEARCH_ONLY_KEY`
|
|
* `Admin API KEY -> ALGOLIASEARCH_API_KEY`
|
|
|
|
|
|
|
|
8. Done!
|
|
|
|
That's it! You should try logging in with development, it should work. If it doesn't, let us know via an issue or in the contributors channel!
|
|
|
|
### _The following are optional, but are probably things you'll run into. That said, if you're working on tests and other things, you shouldn't need these._
|
|
|
|
### For authentication, you can choose Twitter, GitHub, or both.
|
|
|
|
# Twitter App
|
|
|
|
1. [Click this link and sign in/sign up for a Twitter account.](https://apps.twitter.com) Note that your Twitter account will need a phone number linked to it in order to create an app.
|
|
2. Create a new app, and fill out the form, like the following example image: 
|
|
|
|
The only important field is the "Callback URL" `http://localhost:3000/users/auth/twitter/callback`, which redirects you properly to `localhost:3000` when signing in.
|
|
|
|
3. Once done, go to your app's settings, and fill in the terms of service `http://dev.to/terms` and privacy policy URL `http://dev.to/privacy`:
|
|
|
|
|
|
|
|
4. Once done, go to your app's permissions, and check the "Request email addresses from users" box.
|
|
|
|
|
|
5. Change your keys accordingly: (name of Twitter key -> name of our application key):
|
|
|
|
* `Access Token -> TWITTER_KEY`
|
|
* `Access Token Secret -> TWITTER_SECRET`
|
|
|
|
6. Done!
|
|
|
|
# GitHub
|
|
|
|
1. [Click this link and sign in/sign up for a GitHub account.](https://github.com/settings/applications/new)
|
|
2. Once signed in, create a new OAuth app. Here's an example; the URLs must match the example:
|
|
|
|
3. Change your keys accordingly; (name of GitHub key -> name of our application key):
|
|
|
|
* `Client ID -> GITHUB_KEY`
|
|
* `Client Secret -> GITHUB_SECRET`
|
|
|
|
4. Done!
|
|
|
|
# Stream
|
|
|
|
1. [Sign up for an account with this link](https://getstream.io/accounts/signup/), using either your email or GitHub.
|
|
|
|
|
|
|
|
2. Click "View Dashboard" at the top right corner.
|
|
|
|
|
|
|
|
3. **In the next page, click "Add New Feed Group".**
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
4. Add a new feed group with the type "Notification" and name it `notifications` (case sensitive).
|
|
|
|
|
|
|
|
5. Make sure you have a feed group with the type "Flat" and named `user` (case sensitive). You probably do, but if you don't, create one like you did with the notifications feed group.
|
|
|
|
6. Change your keys accordingly: (name of Stream key -> name of our application key):
|
|
|
|
* `Key -> STREAM_RAILS_KEY`
|
|
* `Secret -> STREAM_RAILS_SECRET`
|
|
* `"https://us-east-api.stream-io-api.com/api/v1.0/" -> STREAM_URL`
|
|
|
|
7. Done!
|