The platform of the global Fab Labs Network
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app Fixes css img issue with assets pipeline Jul 20, 2018
bin bumped rails to 4.2 Apr 26, 2018
config Removes opbeat Jul 18, 2018
containers Dockerize project, further testing is needed! Jan 26, 2018
db Doorkeeper gem update (requires migration) Sep 4, 2018
lib Issue #362. Supernode labs do not longer exist Jul 19, 2018
log initial commit Oct 16, 2013
public Use dragonfly thumb url Jan 28, 2017
scripts backup script for dockerized postgres Jun 28, 2018
spec Merge branch 'master' into 394-mandatory-email-for-lab Jul 20, 2018
vendor/assets Fix libraries Mar 15, 2017
.bowerrc Removing foundation Jan 6, 2017
.gitignore Ignore .env file Jan 26, 2018
.powenv First commit May 22, 2015
.powrc First commit May 22, 2015
.rspec updated specs, adding integration tests folder May 3, 2018
.ruby-version Update ruby 2.3.1 -> 2.3.7 Sep 13, 2018
.rvmrc First commit May 22, 2015
.travis.yml Travis uses .ruby-version file Sep 13, 2018
Capfile Deploy fixes Jun 5, 2015
DEV.md Merge branch 'master' of github.com:fablabbcn/fablabs.io into api_v3 May 15, 2018
Dockerfile Update Dockerfile and npm versions Sep 13, 2018
Gemfile Update ruby 2.3.1 -> 2.3.7 Sep 13, 2018
Gemfile.lock Update gem Sep 13, 2018
Guardfile bumped rails to 4.2 Apr 26, 2018
LICENSE Change license from GPL to AGPL Oct 27, 2016
Procfile activity feed, temp disabled employee specs Dec 2, 2013
README.md Update readme Sep 13, 2018
Rakefile Fix rake bug, calls removed function 'last_comment' Jan 26, 2018
TODO.todo more work Nov 24, 2013
apiary.apib Issue #362. Supernode labs do not longer exist Jul 19, 2018
bower.json Move from bootstrap glyphicons to fontawesome Mar 16, 2017
config.ru initial commit Oct 16, 2013
docker-compose.yml Update Dockerfile and npm versions Sep 13, 2018
env.example Update Dockerfile and npm versions Sep 13, 2018
swagger.json Added map method to lab api, and tests Jul 3, 2018
swagger.yml Added map method to lab api, and tests Jul 3, 2018

README.md

FabLabs

Code Climate Build Status Test Coverage

This is the official repository for fablabs.io platform project.

Fab labs provide widespread access to modern means for invention. They began as an outreach project from MIT’s Center for Bits and Atoms (CBA), and became into a collaborative and global network. You can find more information about Fab Labs on the Fab Foundation Website.

If you are a Fab labs entusiast and/or you would like to contribute to the project please feel free to get in touch by opening a new issue.

Getting started

  1. bower install

  2. rake db:setup

  3. rails s

  4. Add this to your /etc/hosts:

    127.0.0.1 www.fablabs.local 127.0.0.1 api.fablabs.local

  5. Visit http://www.fablabs.local:3000

Tests

Run tests with:

bundle exec rake

Starting with docker-compose

  1. Add all the secrets to an .env file - Minimum example is in the env.example file

  2. Start the project:

    docker-compose up web app

  3. Create database (only the first time):

    docker-compose exec app rake db:setup

    docker-compose exec app /usr/local/bin/bower install

  4. Add this to your /etc/hosts:

    127.0.0.1 www.fablabs.local

    127.0.0.1 api.fablabs.local

  5. Visit http://www.fablabs.local:3000

  6. API is served on http://api.fablabs.local:3000

  7. Add test users and data with

    docker-compose exec app rake db:seed

    This will create a normal user (email=user@user.local, password=password) and an admin user (email=admin@admin.local, password=password)

  8. Run tests with

    docker-compose exec app rake db:setup RAILS_ENV=test

    docker-compose exec app rake spec

  9. If you make changes to the code, rebuild the app and deploy the new image

    docker-compose build

    docker-compose up -d

  10. Backup your db at any time with the included script:

    ./scripts/docker-backup-db.sh
    

API Documenation

Take a look at the developer guide for information on how to integrate Fablabs.io in your application.

Check out also the API Reference, the Examples, and the fablabs.js library.

Pull requests

All PRs are tested on Travis. Make sure the tests run fine.