allReady, a project where you can help and feel great about it...
Looking to be involved in a project where you can really help? Help and feel great about it, that you're doing something that will help your fellow man, when they need it most?
Of just looking for a couple cool projects, web and cross-platform, to spelunk?
First check out, In the Code - App Overview and Planning
What is allReady
While we can’t stop disasters from happening, we can lessen their impact on our families and the communities we live in by being prepared. Preparedness is a key factor in reducing impacts and together citizens & organizations can build resilient communities. No one can eliminate disasters, but together we can be ready to be safer, save lives and recover faster when the unexpected happens.
allReady brings together community members, volunteers, humanitarian and community organizations to make our communities more resilient to the effects of disasters by making preparedness activities more visible and effective to the communities they serve and the volunteers who support them.
In fact, allReady itself came from a group of folks across non-profits, software organizations and open source communities who volunteered to work together to build a solution to connect communities with opportunities to prepare, bringing communities and volunteers together, and increasing community preparedness.
Contributing to and Using allReady
Contributing to allReady as a coder, tester, designer, or project manager can be done at its GitHub repository at https://github.com/HTBox/allReady
At the moment, we are working on getting allReady to a 'v1' for initial release and use by community and non-profit organizations. When we are ready to go live we will update this page and announce it on our website and twitter account. In the meantime, checkout the repository mentioned above (in particular the issue and milestone lists) to see what what issues and features we are planning to release and suggest features/requirements for us to build with our community of volunteers.
Specific information for getting started with the development of allReady can be found in our readme in the GitHub repository.
This repo contains the code for allReady, an open-source solution focused on increasing awareness, efficiency and impact of preparedness campaigns as they are delivered by humanitarian and disaster response organizations in local communities.
- Project overview
- How you can help
- Solution architecture
- Get started with the allReady solution
allReady is focused on increasing awareness, efficiency and impact of preparedness campaigns as they are delivered by humanitarian and disaster response organizations in local communities. As preparedness and resliency of a community increases the potential for impactful disasters (both large and small) is greatly decreased. The rule of thumb in the industry is that an hour or dollar spent before a disaster is worth 15-30 afterwards. However preparedness activities, like ensuring working smoke detectors are in homes, are often not as visible or emotionally salient as saving children from a burning building - for example. Theh goal of allReady - in part - is to grow awareness and engagement of communities and volunteers in preparedness campaigns to grow their impact and - aspirationally - "put disaster response out of business" through communities that are fully prepared and reslient to inevitable disasters.
To learn more about the need for allReady, the technologies, and how the app came together, view the project information and blog post on the Humanitarian Toolbox website and watch the In the Code video series:
This project, which was jumpstarted by volunteers at Microsoft, has been turned over to Humanitarian Toolbox so that it can be maintained and improved by the technical community at large and ultimately deployed in support of organizations delivering preparedness campaigns everywhere.
The initial launch of development for allReady started on 7/20/2015 during the Visual Studio 2015 release event.
How you can help
To help make improvements to this project, you can just clone this repository and start coding, testing, and/or designing.
Before jumping in, please review the solution architecture and instructions below to get started.
As of this writing (week of 7/20/2015), we are focused on expanding and filling out our documentation, issues lists, milestones plan and supporting any issues that arise as the community first starts to engage with the codebase. Soon in addition to the codebase you should be able to find issues of all types (simple bugs, new feature & requirements and architectural updates) upon which you can contribute to the project. In the meantime, if you find any issues with the codebase or other content in our repository please log an issue and we will work with you to solve it.
Thank you for considering supporting this open source project for humanitarian support.
The allReady application is implemented as a Visual Studio 2015 solution that contains two projects: an ASP.NET 5 project that serves the web site and admin portal, and a cross-platform Cordova app project. The web application also exposes the REST APIs used by the mobile app to access data.
An ASP.NET 5 web application provides the front-end web experience for volunteers accessing the allReady web site and the portal used by administrators. The site is powered by ASP.NET MVC 6 using .NET 4.6 and a dependency on .NET 4.5.1. Here's the landing page for the web site:
Cross-platform mobile app
The mobile app project was added to the allReady solution as a Visual Studio Tools for Apache Cordova project.
The client app relies on the following frameworks:
- AngularJS: extensible web app framework
- Apache Cordova: cross-platform device deployment, including these plugins:
- Ionic: enhancements for Cordova apps
- Moment.js: working with date-time values
The app accesses the Web API exposed by the web app for data access.
Go grab it, kick the tries and chip in!