To make full use of this, you must have installed git, ruby on rails (version 3.2, with ruby version 1.9), and the heroku toolbelt (for deployment). You also need a (free) account for dailycred to handle authentication.
To use social sign-in, you must first create an application for Facebook, Twitter, Google, and Instagram. You can view instructions and set API keys on your settings page. To get started, simply open your terminal and run:
git clone firstname.lastname@example.org:hstove/launchy.git cd launchy && bundle install
Open up the newly downloaded 'launchy' folder in your favorite text editor, and open up the file
config/initializers/omniauth.rb. Change the first two lines to use your dailycred API keys, located on your account page. Replace the default
YOUR-CLIENT-SECRET with your api keys. The first two lines should look something like this before you change them:
Rails.configuration.DAILYCRED_CLIENT_ID = ENV['launchy_dc_id'] || "YOUR-CLIENT-ID" Rails.configuration.DAILYCRED_SECRET_KEY = ENV['launchy_dc_secret'] || "YOUR-CLIENT-SECRET"
rails s and open your browser to http://localhost:3000.
You're all set! You have a fully running landing page where users can create real accounts and sign up with Facebook, Google, and Twitter. This has an advantage over other email-only options in that you can get a better idea of who your users are. Also, if you decide to build out a real application, you can keep all the same users who have already signed up for you.
There are three preset options for the background image. open
app/assets/stylesheets/welcome.css.sass. Around line 8, you should see these lines:
//all photos are Creative Commons attribution license //:background-image url('/assets/bg2.jpeg') //photo cred: <a href="http://www.flickr.com/photos/62313790@N00/">ilya_ktsn</a> :background-image url('/assets/bg3.jpeg') //photo cred: <a href="http://www.flickr.com/photos/62313790@N00/">ilya_ktsn</a> //:background-image url('/assets/bg.jpeg') //photo cred: <a href="http://www.flickr.com/photos/bnsd/">Bengt Nyman</a></p>
Feel free to comment out one line and un-comment another to play with different background images. Be sure to change the photo cred when you do in
app/views/layouts/application.html.erb because these photos are Creative Commons attribution liscensed, found on flickr creative commons. Feel free to find your own!
To remove the social sign-in buttons, open
app/assets/stylesheets/welcome.css.sass and uncomment lines 98-103, so that instead of:
// .social-connect :display none .email-connect :float none !important :margin 0px auto
It looks like this:
.social-connect :display none .email-connect :float none !important :margin 0px auto
There are four main messages: two on the welcome page, and two on the 'thanks' page. All four of these messages are conveniently located in the file
config/locales/en.yml. Simply open this file and start changing the text to be specific to your application.
You may run out of space for text inside the 'container' element. If that is the case, consider changing the height of that element on line 1 of
Launchy is set up out-of-the-box with functional and integration tests. It also is set up with guard and spork for running your tests in the background. To run
guard, simply run
guard in your terminal. Run
rake test:functionals if you simply want to run your functional tests once.
Since you own this rails project after you clone it, you can do whatever you want with it. Feel free to build an application on top of this, as you already have authentication all set up.
This project is all set up to deploy to heroku's free tier. Open your terminal and run:
heroku create my-apps-name git add . && git commit -m 'push to heroku' git push heroku master heroku run rake db:migrate
At this point, you should be able to open and share your app on heroku with the world!
We'd love to hear any feedback from you about how we can make our product easier to use and more powerful. If you've run into any hiccups along the way, feel free to email email@example.com for any help and we'd love to assist you.