This is the Bike Index ![Build Status](https://camo.githubusercontent.com/19a3ccba1a95ab9eafc6ca14a3f75edd857ec54d52617718333e28b4907728fa/68747470733a2f2f7472617669732d63692e6f72672f62696b65696e6465782f62696b655f696e6465782e7376673f6272616e63683d6d6173746572)
Bike registration that works: online, powerful, free.
Registering a bike only takes a few minutes and gives cyclists a permanent record linked to their identity that proves ownership in the case of a theft.
We're an open source project. Take a gander through our code, report bugs, or download it and run it locally.
-
Ruby 2.2.5 (we use RVM)
-
PostgreSQL >= 9.4
-
Imagemagick (railscast)
-
Sidekiq, which requires Redis. The RailsCast on Resque is a good resource for getting up and running with Redis.
-
If you turn on caching locally: Dalli (railscast - you will need to install and start memcached
/usr/local/bin/memcached
) -
Requires 1gb of ram (or at least more than 512mb)
This explanation assumes you're familiar with developing Ruby on Rails applications.
-
bundle install
install gems -
rake db:setup
create and seed your database -
rake seed_test_users_and_bikes
to:- Add the three test user accounts: [email protected], [email protected], [email protected] (all have password
please12
) - Give [email protected] 50 bikes
- Add the three test user accounts: [email protected], [email protected], [email protected] (all have password
-
./start
start the server.- start is a bash script. It starts redis in the background and runs foreman with the dev procfile. If you need/prefer something else, do that
-
Go to localhost:3001
- if you want to use Pow (or some other setup that isn't through localhost:3001), change the appropriate values in session_store.rb and .env.
We use RSpec and Guard for testing.
-
Run the test suit in the background with
bundle exec guard
-
You may have to manually add the fuzzystrmatch extension, which we use for near serial searches, to your databases. The migration should take care of this but sometimes doesn't. Open the databases in postgres (
psql bikeindex_development
andpsql bikeindex_test
) and add the extension.
CREATE EXTENSION fuzzystrmatch;
Have a bug or a feature request? Open a new issue.
Keep track of development and community news.
- Follow @bikeindex on Twitter.
- Read the Bike Index Blog.
Open a Pull request! The earlier you open the pull request, the earlier it's possible to discuss the direction of the changes.
If your pull request contains Ruby patches or features, you must include relevant rspec tests.
... and go hard