Skip to content
Sharpen your programming skills.
Ruby HTML CSS Other
Branch: master
Clone or download
Latest commit 4420b6a Oct 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Use ruby version 2.6.5 Oct 15, 2019
app Update pg_search to version 2.3.0 Jul 15, 2019
bin Update rails to version 5.2.0 Jul 10, 2018
config Remove asset_host config from production Aug 28, 2019
db Remove GitHub collaborator integration May 24, 2019
lib Avoid dynamic finders in dev rake Nov 29, 2018
public/upcase Update to allow hosting on thoughtbot.com/upcase May 5, 2016
spec Fix capybara warning about checking for blank content Jul 25, 2019
vendor Update the discourse SingleSignOn class to latest Jul 13, 2018
.env.test Drip implementation Oct 28, 2016
.gitignore Update circle config to capture timing results Oct 1, 2018
.hound.yml Disable class documentation rule from Hound Mar 14, 2017
.irbrc Avoid dynamic finders in irbrc Nov 29, 2018
.javascript-style.json Tell Hound that Upcase is defined Mar 30, 2016
.jshintrc Add Explore menu to signed-out header Aug 4, 2015
.pryrc Revert disabling pry pager Jan 2, 2016
.rspec Remove billing & upgrade content from profile page Oct 17, 2018
.rubocop.yml Update namespace for flipflop rubocop rule Mar 19, 2019
.ruby-version Use ruby version 2.6.5 Oct 15, 2019
.sample.env Remove asset_host config from production Aug 28, 2019
.scss-lint.yml Configure hound to allow for shorthand with 4 args. Oct 16, 2017
Gemfile Use ruby version 2.6.5 Oct 15, 2019
Gemfile.lock Use ruby version 2.6.5 Oct 15, 2019
Guardfile Add new marketing page for a/b testing Mar 7, 2017
Procfile Use puma instead of unicorn Jan 14, 2016
README.md The application is running rails version 5 May 24, 2019
Rakefile Run `rails app:update` for rails five changes Jun 13, 2018
config.ru Run `rails app:update` for rails five changes Jun 13, 2018

README.md

Upcase

Upcase is a Rails 5 app deployed to Heroku.

Development

Rules of the road

This project is now following Sandi Metz's Rules.

You can read a description of the rules here.

All new code should follow these rules. If you make changes in a pre-existing file that violates these rules you should fix the violations as part of your work.

Setup

  1. Get the code.

     % git clone git@github.com:thoughtbot/upcase.git
    
  2. Setup your environment.

     % bin/setup
    
  3. Start Foreman.

     % foreman start
    
  4. Verify that the app is up and running.

     % open http://localhost:5000/upcase
    

Designing In The Browser

We are using https://github.com/guard/guard-livereload and https://github.com/johnbintz/rack-livereload. When you save a file, the open browser will automatically refresh, and you can view your changes.

Run bundle exec guard to start the guard server to auto refresh your browser.

Protocol

  1. Look for cards in the Next Up list.
  2. When you start a card, add yourself and move the card to the In Progress list.
  3. When opening a pull request, move the card to the Code Review list and ask in Slack for a review.
  4. Once the review is complete, merge into master as usual. Wait for CI to finish running the build.
  5. Once CI is finished running the build, it will deploy to staging. Move the card to On Staging for acceptance at this time. Comment on the card with acceptance instructions. Include a URL to staging. Ask in Slack for acceptance.

In order to avoid bottlenecks and confusion:

  • Try to only work on one card at a time. Bring all the way from Next Up to Verified on staging as quickly as possible.
  • Prioritize reviewing others' work, both during code reviews and acceptance on staging.
  • Feel free to be persistent when looking for reviews and acceptance.

For more information, check out the guides and Playbook.

Continuous Integration

CI is hosted with CircleCI. The build is run automatically whenever any branch is updated on Github.

Ongoing

  • Run test suite before committing to the master branch.

      % rake
    
  • Reset development data as needed.

      % rake dev:prime
    
  • Dump production data into your local db. (Note that you need to drop your local database first).

      % rake db:drop
      % heroku pg:pull DATABASE_URL upcase_development -r production
    
  • To test that adding/removing GitHub users works, use the GitHub user "cpyteltest".

Amazon AWS S3

To test integration with AWS S3, set the following environment variables:

AWS_BUCKET
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY

Deployment

CircleCI deploys to staging automatically when a build passes on master.

Once your changes have been verified on staging, deploy to production:

./bin/deploy production

Sending email on staging

We override the recipient on staging to be ENV['EMAIL_RECIPIENTS'] so that no one else can receive email from the staging server.

We have it set to learn+staging@thoughtbot.com, which is a mailing list. Instead of changing the variable, ask to be put on the mailing list.

To set it:

heroku config:set EMAIL_RECIPIENTS=gabe@thoughtbot.com,melissa@apprentice.io -r staging

To see what the current recipient is:

heroku config:get EMAIL_RECIPIENTS -r staging

Viewing email in development

To preview how emails look in the browser without having to send them (via staging) you can visit the rails mailer preview index and navigate to the emails that have preview classes implemented.

To preview the emails point your browser to http://localhost:5000/rails/mailers and select the mailer there.

Product Management

Check the Upcase processes repository for guides on where to find and how to do common tasks like customer support, content production, related repositories and trello boards, and others.

Admin Access

  1. Register on the Upcase site.

  2. Update your user.

     % heroku run console -r production
     % user = User.find_by_email('foo@example.com')
     % user.admin = true
     % user.save!
     % exit
    
  3. Access the general admin panel or the workshop admin panel.

Testing With User Accounts

The rake dev:prime task will create user accounts that you can test with in development mode.

Credits

thoughtbot

This application is maintained and funded by thoughtbot, inc

Thank you to all the contributors!

The names and logos for Upcase and thoughtbot are registered trademarks of thoughtbot, inc.

License

This application is Copyright © 2007 thoughtbot, inc.

If you submit a Contribution to this application's source code, you hereby grant to thoughtbot, inc. a worldwide, royalty-free, exclusive, perpetual and irrevocable license, with the right to grant or transfer an unlimited number of non-exclusive licenses or sublicenses to third parties, under the Copyright covering the Contribution to use the Contribution by all means, including but not limited to:

  • to publish the Contribution,
  • to modify the Contribution, to prepare Derivative Works based upon or containing the Contribution and to combine the Contribution with other software code,
  • to reproduce the Contribution in original or modified form,
  • to distribute, to make the Contribution available to the public, display and publicly perform the Contribution in original or modified form.
You can’t perform that action at this time.