{"id":16731653,"url":"https://github.com/missinglink/relief.io","last_synced_at":"2025-11-01T04:30:30.987Z","repository":{"id":11724757,"uuid":"14247082","full_name":"missinglink/relief.io","owner":"missinglink","description":"Typhoon Haiyan Support Hack","archived":false,"fork":false,"pushed_at":"2013-11-11T21:31:44.000Z","size":30272,"stargazers_count":17,"open_issues_count":5,"forks_count":5,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-04-14T18:28:41.077Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://relief.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/missinglink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-08T23:19:06.000Z","updated_at":"2019-07-08T15:38:42.000Z","dependencies_parsed_at":"2022-09-06T05:10:36.519Z","dependency_job_id":null,"html_url":"https://github.com/missinglink/relief.io","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Frelief.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Frelief.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Frelief.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/missinglink%2Frelief.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/missinglink","download_url":"https://codeload.github.com/missinglink/relief.io/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239257094,"owners_count":19608629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T23:38:22.684Z","updated_at":"2025-11-01T04:30:30.937Z","avatar_url":"https://github.com/missinglink.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Hack4Good - Typhoon Haiyan\n==========================\n\nThis is a repo for ideas, data, and code to help with disaster relief in the Philippines.\n\nThe app is built with `nodejs`+`angular`, uses `firebase` for the sockets \u0026 has some `mongodb` examples.\n\n## Contributing to the project\n\nPlease help out where you can, I'm happy for this repo to be the base for a bunch of projects that can all live at http://relief.io or you are free to fork it and create another site.\n\nJoin in the chat here: https://www.hipchat.com/g9bBgsIwG\n\nHackathon page: https://geekli.st/hackathon/52793a2660fb3f52d50001f8\n\nPlease star the repo and spread the word on twitter.\nhttps://twitter.com/insertcoffee/statuses/399232533910409216\n\n## Setting up for development\n\nNote: you will need `node` and `npm` installed first.\n\nThe easiest way to install `node.js` is with [nave.sh](https://github.com/isaacs/nave) by executing `[sudo] ./nave.sh usemain 0.10`\n\nClone the repo, enter the directory and type:\n\n```bash\n$ npm install\n\n$ [sudo] npm install bower -g\n$ bower install\n\n$ npm start\n```\n\nYou should now be able to access the server here: `http://localhost:3000/`\n\n## Project Structure\n\n### Backend\n\n- All server files live in the `/server` directory.\n- Controllers live in the `/server/controllers` directory.\n- General app config lives in the `/server/app.js` file.\n\n### Backend Dependencies\n\n- Try to use npm where possible, record dependencies in `package.json` or use the `--save` flag with `npm`\n\n### Frontend\n\n- All frontend files live in the `/public` directory.\n- Angularjs components are split up in to `features` in the `/public/features` directory.\n- Inside each feature can be controllers, services, styles and views related to that specific feature.\n- Each feature may include an `init.js` file to initialize routes and services.\n- Generic styles \u0026 services can live in `/public/style` \u0026 `/public/services.js`.\n- The main angular app config lives in `/public/app.js`\n- The layout file is rendered in jade and passes session and user info from the backend to the frontend. This lives in `/public/index.jade`\n\n### Frontend Dependencies\n\n- Try to use bower where possible, record dependencies in `bower.json` or use the `--save` flag with `bower`\n- Other 3rd party code can live in `/public/vendor`.\n\n## Developing a new feature\n\n### Frontend\n\nThe frontend is built with `angularjs`, which is pretty simple if you have experience with a javascript MVC framework. `Jquery`, `underscore` \u0026 `Twitter Bootstrap` are also included.\n\n- Create a new directory for the feature `/public/features/myfeature`. (it may be easier to copy an existing one)\n- Modify `init.js` to set up your routes and rename the controllers etc.\n- Edit `/public/app.jade` in the `// ========= Features =========` section to add your new feature. (it may be easier to copy an existing one)\n- You can modify `/public/features/menu/menu.html` to add your new feature to the top menu.\n\n### Adding information to a map\n\nThe mapping lib `leafletjs` is included and some example code can be found in the `map` feature directory. ( `leaflet` functions all start with `L.` )\n\n- http://leafletjs.com/\n- https://github.com/missinglink/relief.io/blob/master/public/feature/map/IndexController.js\n\n### Backend\n\nThe backend is built with `nodejs`. If you have experience with `ruby` or `PHP` etc you should be fine copy-\u003epasting to get you started. The server is based on `expressjs` \u0026 the sockets are using `firebase`.\n\n- Create a new controller in `/server/controllers` or a service in `/server/services`. (it may be easier to copy an existing one)\n- Edit `/server/app.js` in the `// Controllers` or `// Services` section to add your new feature. (it may be easier to copy an existing one)\n\n## Some Phillipines geo data files can be found here:\n\nhttps://github.com/coryarmbrecht/Hack4Good--Typhoon-Haiyan/tree/master/data/geo","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmissinglink%2Frelief.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmissinglink%2Frelief.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmissinglink%2Frelief.io/lists"}