webuildsg / webuild

:memo: Robot-handpicked list of open events and open source for designers, developers and makers in Singapore
https://webuild.sg/
MIT License
62 stars 33 forks source link
events open open-source repositories singapore webuild

We Build SG

Dependency Status Build Status Code Climate Coverage Status Gitter

We Build SG automatically curates a list of free public developer / design events from Facebook / Meetup / Eventbrite / ICS url / manual and open source projects from Github for the curious folks who love to make things in a particular city.

Quick start

  1. clone this project and install dependancies:

    git clone git@github.com:webuildsg/webuild.git && cd webuild
    gem install foreman thor tmuxinator
    gem install dotenv -v 0.11.1
    gem install dotenv-deployment -v 0.0.2
    npm install -g bower grunt-cli
    npm i && bower install
  2. Setup environment variables. Refer Environment Variables section for more details.

    cp .env.sample .env
  3. Start the website locally with ./run.sh

Background

Repositories curated automatically every hour:

  1. Github repositories
    • user location contains Singapore
    • repos with more than 50 watchers
    • repos pushed date less than 3 months ago

Events curated automatically every hour:

  1. Facebook selected groups
  2. Meetup.com / Eventbrite event category Technology, free, has a valid location
  3. ICS url
  4. Manually added events

API endpoints

The events, repositories and podcasts data feeds are available in public as JSON format. Please refer to the list of API endpoints

Archived data

A daily snapshot of the repos and events API V1 endpoints are stored in the archives for data analysis at data.webuild.sg.

Environment variables

Set the following environment variables on your system:

Use an external "web cron" service to periodically refresh the GitHub data feed. Keep in mind that due to GitHub API rate limiting it may take >15 minutes to retrieve the entire feed. Register a GitHub OAuth application and configure the GITHUB_CLIENT_* environment variables (see above) to increase the rate limit. Do not refresh the feed too often or the rate limit will cause it to take longer.

Create an Auth0 account (you get one free app) and a Facebook app and link them with these instructions. Configure the WEBUILD_AUTH0_CLIENT_* environment variables (see above) and add your callback url in auth0. Run the app and if all is configured well, add your fb aceess token by logging in at <localhost>/admin

Firebase related environment variables

  1. Open a Firebase account
  2. Create a new app for this project
  3. Under Login & Auth > Registered Users > Add User
  4. Note the email, password, user uid and firebase unique app url for the following variables:
    • FIREBASE_EMAIL (required): .
    • FIREBASE_PASSWORD (required)
    • FIREBASE_UID (required)
    • FIREBASE_URL (required)

Contribute

Please see CONTRIBUTING.md for details.

Versioning

Every production code has a version following the Semantic Versioning guidelines. Run the grunt bump, grunt bump:minor or grunt bump:major command to bump the version accordingly and then push to production with git push production master.

License

We Build is released under the MIT License.