What's in this repo
Hybrid client for Share My Cart for Web, iOS, Android
tl;dr: An app for collaborative neighborhood groceries shopping, so we can stay contained and help not spread viruses
Isolation is key to not spreading the virus. Whether it's because we're locked down, because we feel sick or because we simply put ourselves in a home-quarantine: We need to reduce public movement.
Buying groceries is something we all need to do from time to time. I'll be out probably on Friday. I'll make a shopping list, I'll order it so that I spend as few time as possible in-store, I'll buy only necessary stuff, not more than I need for my family for the week. It would be easy for me to add another item for my neighbours if I only knew they also need the same stuff - and it would enable them to stay home.
It's really a simple process which is a (small) solution to a universal problem worldwide.
This project is in a very early stage. It's 2020, March 18 and Sars-Cov-2 is spreading like crazy in Europe. Though this project sounds a bit miniscule (and maybe even ridiculous compared to other initiatives like 3D-printing respirator valves for those already fighting death ), but it's something for the better. And it's something I can do.
A fist website (in German) is online at sharemycart.com.
How to contribute
So you really would like to join? Awesome! Have a look at the issues, best start with the epics. There is also an issue board outlining the next todos Then, you can get in tough with the very new team on a channel on the open Rocket.Chat server
Getting started as a developer
DB and backend
The current implementation, Firebase's Firestore is being used. Firestore supplies mechanisms for reactivity and grants maximal freedom due to being hosted and scaled by Google.
Firestore also allows for implementing functions in Golang. This is waht we currently call the
The client is implemented using the Ionic framework and React. Since the DB side is schema-less, the client also comprises a larger part which is responsible for data binding and business logic:
Firestore and the backend functions are consumed in the "client side backend", which is responsible for providing data access to the frontend:
firebaseServiceprovides low-level functions wrapping the firestore API. It ensures the schema and could (and will in future) be provided by server-side functions. The firebase service is only intended to be used from the
- The models are React components which can be used as superclasses of the pages displayed on the UI. They hook into the React component lifecycle in order to set up listeners to the database which in turn fill the
stores. Also, they provide handlers for business functions, wrapping the firebase services.
storesprovide singleton caches of the data retrieved from the database. They can be injected into every component which needs it.
The UI components are implemented in React using the Ionic library for react
How to best understand the current code base
The current code is dased upon the awesome React + Firebase + MobX Tutorial
You can start from the tutorial. You like to get into the code quickly? Then ou are probably best off by launching the app from the
ui folder using
npm start. Be sure you provided the credentials either as environment variables (see [
.env.sample]((https://github.com/mrsimpson/sharemycart/blob/master/ui/.env.sample) for how it has to look like).
You are not a coder but still want to help Even more great! Check the issues, comment on epics, write own ideas, join the chat. Looking forward to reading from you.