clerb-rails

clerb-rails is the website for the Cleveland Ruby Brigade, built with Ruby on Rails.

Development

Setup

1. Clone the repository (git clone https://github.com/clerb/clerb-rails.git)
2. Install gems: bundle install
3. Install npm packages: yarn install
4. Install PostgreSQL
5. Setup a new role with SuperUser permissions for PostgreSQL
6. Create the database and run any pending migrations: bundle exec rake db:create db:migrate
7. Pull down and seed the database with events from the meetup API: bundle exec rake refresh_meetup_events
8. Start the Rails server: bundle exec rails s
9. Visit http://localhost:3000 in your browser

Google Maps setup

The event details page contains an embedded Google Map of the event location. Google's maps API requires an authenticated API token for embeds to work. To set this up for development:

1. Visit the Google developer console
2. Click the project dropdown in the top left and select "New Project" in the modal. Name it something like "CLERB-dev" (doesn't really matter)
3. Search for "Maps Embed API", click on the result, and select "Enable"
4. Click the "Credentials" tab. Select "Create credentials" -> "API key" and copy the generated key
5. Create a file named .env in the Rails project directory with the following contents:

GOOGLE_MAPS_API_KEY=<your_copied_key>

GitHub integration setup

1. Visit GitHub and create a new access token here
2. Add two variables to your .env file

GITHUB_REPO=clerb/clerb-rails
GITHUB_ACCESS_TOKEN=some-access-token-that-you-created-in-step-1

NOTE: For testing purposes, you may want to create a temporary GitHub Repo for GITHUB_REPO.

Contributing

1. Fork it (https://github.com/clerb/clerb-rails.com/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new pull request on GitHub