WeAreYVR is an instance of StartupHealthCheck. See the main repo of SHC for more information.
We like to use RVM and Homebrew to get everything up and running. You can use other tools if you'd like, but we'll use these in our instructions.
Ensure you have Homebrew installed
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
Ensure you have RVM installed
\curl -sSL https://get.rvm.io | bash -s stable
Startup HealthCheck requires ruby version 2.1.1.
rvm install 2.1.1
We use ElasticSearch as our full-text search engine.
brew install elasticsearch
To start ElasticSearch, try this:
brew services start elasticsearch
If you get errors, ensure you have the latest version of the JDK (1.7).
Install PostgreSQL, the best thing since MySQL. You can install PostgreSQL with Homebrew.
brew install postgresql
Start PostgreSQL
brew services start postgresql
Clone the repository from git:
git clone [email protected]:PixelCrafters/StartupHealthCheck.git
Change directories into startuphealthcheck:
cd startuphealthcheck
Run Bundler (http://bundler.io):
bundle install
Set up your database.
Start by creating a config/database.yml file with your database settings (based on the config/database.yml.sample file). The following command will create the database, run the migrations and add the seed data to the application.
bundle exec rake db:setup
After you've setup your database, you will have two example organizations in the database (Example Startup and Example Startup2). In order to access these organizations via search add data to the search index.
bundle exec rake searchkick:reindex CLASS=Organization
You'll need to run a similar command to index People / users in the database.
bundle exec rake searchkick:reindex CLASS=User
Start the rails server:
rails server
We use the dotenv-rails gem to populate environment variables for development and test environments. To configure your application you will need to create a .env file in the root directory of your application. See the .env.example file to get started.
After you have your database schema set up and .env file ready, you can begin running tests with either RSpec (https://github.com/rspec/rspec) or Cucumber (http://cukes.info).
In order to pull data from Startup Genome, you will need a Startup Genome API AUTH_CODE. You can get one of these by going to startupgenome.co and registering as curator.
Once you're approved as a curator, you'll be able to request an AUTH_CODE from Startup Genome through your account.
Once you have your AUTH_CODE, set STARTUP_GENOME_AUTH_CODE in your .env file.
You will also need the Startup Genome slug for your location. You can find this by visiting startupgenome.co, searching for your city/location, and taking a look at the URL. For instance, when we search for Vancouver on Startup Genome, we find that the url to access Vancouver is http://startupgenome.co/vancouver-britishcolumbia-can, and thus the slug is vancouver-britishcolumbia-can. Once you know your slug, set STARTUP_GENOME_LOCATION_SLUG in your .env file.
If you find this process frustrating, you could try sending the good people at Startup Genome a very polite email requesting additional documentation.
In order to log into the site, you will need to set up your application for Auth0.
Go to [https://auth0.com/] and create a free account.
1.Create an Auth0 domain. You can use your sweet name or whatevs.
2.Turn on Facebook, LinkedIn, Twitter and Google. Don't enable email sign ups.
3.Add a new application. Click on Ruby on Rails. The friendly name should be WeAreYVR.
4.It will ask you for what you'd like to set up. Turn on Facebook, LinkedIn, Twitter and Google. Don't enable email sign ups (we realize this is repetitive, sorry).
5.Go to Applications, click on WeAreYVR and change the "CHANGE-TO-YOUR-PORT" to 3000.
6.you don't need to add all of this code to the application. You just need to set the AUTH0_DOMAIN, AUTH0_CLIENT_ID, AUTH0_SECRET and AUTH0_CALLBACK_URL in your .env file. You can find these values on this page.
To run Cucumber:
cucumber
To run RSpec:
rspec spec
We use the Themes on Rails gem for multi-theme support.
Right now Startup HealthCheck has the following themes:
- Default (app/themes/default)
- WeAreYVR (app/themes/weareyvr)
To change the theme from 'WeAreYVR' to 'Default', replace the following line in app/controllers/application_controller.rb
theme "weareyvr"
...with...
theme "default"
After you've made this change, restart your server.
To override a view file simply recreate it within your theme directory and make any changes (ie. app/themes/{theme-name}/views/{file-name}).
To create custom themes have a look at the Themes on Rails documentation.