This project is in an early development stage and should only be installed by developers. Visit https://grassroots.dev or follow @grassrootsdev on twitter for updates on the progress and upcoming release date.
OpenMob is a free open source web framework for the modern civil society organization. Designed specifically with the needs of non profits, political organizations, and activist organizations in mind it includes easy to use out of the box features for fund raising, campaigning, volunteer coordination, and political messaging.
In animal behavior, mobbing is a form of defense used by smaller prey animals(especially birds) against larger predators. The smaller animals band together and harass the predator until it decides the meal is no longer worth the hassle. Since a fundamental goal of this project is to democratize cutting edge political technology by making it more freely available to anyone with the passion and energy to pursue a civic cause or goal, we thought it was an apt metaphor.
- Meet the needs of organizations to provide world class information technology tools to their employees and volunteers.
- Lower organizational costs with an easy to use and low maintenance system.
- Avoid vendor lock-in to provide maximum freedom to organizations wishing to use the software
- Enable powerful experimentation and optimization so organizations can move fast and make measured improvements in their results.
- Provide a fully extensible system allowing organizations to add on, or make changes to meet their unique needs.
- Statically generate landing pages which makes them cheap and fast to host. This provides world class speed even on low cost devices and networks around the world, reduces costs, and increases fund raising conversion.
- All features of OpenMob are plugin based so you can replace components at will.
- OpenMob is a containerized application to allow for the largest possible freedom in where you choose to run your OpenMob deployment while still allowing you to scale as your usage grows.
- A command line tool to help you manage, deploy, and backup your installation.
- Meet all web accessability guidelines to reach the largest possible audience.
- Expose an API for your application so you can build on the core platform any way you want.
You will need the following dependencies to build and run the project.
- GO
- Docker
- Postgres
- Clone the repository
git clone https://github.com/SteveCastle/openmob.git - Enter the project root directory
cd openmob - Run
make bootstrapto install all of the dependencies and build the project. - See the make file for additional make commands you can use.
All commands are from your OpenMob project root.
make servermake client
All commands are from your OpenMob project root.
make test
┌────────────────────┐
│ │
│ │ ┌────────────────────┐
│ Shrike gRPC Server │ ◀──┐ │ │
│ │ │ │ Mobile and Third │
│ │ └───│ Party Platform │
└────────────────────┘ │ Access │
│ │ │
▼ └────────────────────┘
┌────────────────────┐
│ │
│ Wren GraphQL API │
│ Server │
│ │
│ │
└────────────────────┘
│
│
┌────────────────────┐ └─────┐
│ │ │
│ Bluebird React │ ▼
│ Component Library │─┐ ┌────────────────────┐
│ and Design System │ │ │ │
│ │ │ │ Starling Renderer │
└────────────────────┘ └─▶│ (GatsbyJS) │
│ │
│ │
└────────────────────┘
Open Mob is a mono-repo comprised of three core packages. A gRPC API service called Shrike, a GraphQL api server named Wren and a GatsbyJS based rendering engine for content and admin ui called Starling. For more information on building these packages refer to the package level README.
Other Open Source supporting packages like the Bluebird react component library and design system are also found in this repository.
OpenMob makes heavy use of code generation to generate code for common tasks by introspecting the database and outputting database CRUD code, and API handlers. This helps keep the codebase simple, easy to understand, fast to build on, and reliable.
┌────────────────────────┐
│ │
│ │
│ │
┌────────│ PostgreSQL DB Schema │────────┐
│ │ │ │
│ │ │ │
│ │ │ │
│ └────────────────────────┘ │
│ │
▼ ▼
┌────────────────────────┐ ┌────────────────────────┐
│ │ │ │
│ │ │ GNORM - Go template │
│ GNORM - Go template │ │ based templater. A │
│ based templater. │ │ second GNORM pass with │─────────────────────┐
│ │ │settings for Javascript │ │
│ │ │ type mappings. │ ▼
│ │ │ │ ┌───────────────────────┐
└────────────────────────┘ └────────────────────────┘ │ │
│ │ │ │
│ │ │ │
│ └─────┐ │ │
│ │ │ GraphQL Resolvers │
┌──────────────────────────┬─────┴────────────────────┐ ▼ │ │
│ │ │ ┌───────────────────────┐ │ │
│ │ │ │ │ │ │
│ │ │ │ │ │ │
│ │ │ │ │ └───────────────────────┘
▼ ▼ ▼ │ │
┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐ │ GraphQL Schema │
│ │ │ │ │ │ │ │
│ │ │ │ │ │ │ │
│ │ │api/proto/shrike.proto │ │ │ │ │
│ /pkg/service - CRUD │ │ - A Protobuf3 API │ │ /pkg/query - SQL │ │ │
│ Handlers for the gRPC │ │specification and CRUD │ │ Builders for CRUD │ └───────────────────────┘
│ Service. │ │ gRPC service. │ │ Handlers. │
│ │ │ │ │ │
│ │ │ │ │ │
│ │ │ │ │ │
└───────────────────────┘ └───────────────────────┘ └───────────────────────┘