A webapp to coordinate aid and care in the Twin Cities. https://twin-cities-mutual-aid.org/

This project is only a few days old, and things are changing very rapidly. We'll do our best to keep this readme up-to-date, but if something doesn't look right, it's probably out of date.

This project is unusual because there are two separate, siloed teams working in tandem:

• Website team: This team (us) is using a channel within the Open Twin Cities slack to communicate. There's a link at the top of the Open Twin Cities website to join, if you'd like to help out.
• Data team: The team working on updating the underlying data to ensure the real-time info is up-to-date is partly coordinated via a very large Facebook group called South Minneapolis Mutual Aid Autonomous Zone Coordination. We don't have much more information at this time, but will update this when we do.

We're using Github Issues to manage tasks, and have a kanban board set up. If you'd like access to the kanban board reach out in the OTC slack channel.

If you've got a feature request or feedback to share on the website, feel free to submit an issue on GH issues, or bring it up in slack.

Data is sourced from a google spreadsheet.

• Example spreadsheet: https://docs.google.com/spreadsheets/d/1ETV6xakGCkp3dmgfpayjEBQii8p_ElMXYuDut3EDZTE/edit#gid=0
• Google Apps Script utility script also available to automatically update a row timestamp and insert latitude and longitude when an address cell is added or updated: https://github.com/mc-funk/community-map-google-scripts/

To test locally with your own copy of the spreadsheet, duplicate the example spreadsheet, make your changes, and re-publish it. Then follow the steps https://www.freecodecamp.org/news/cjn-google-sheets-as-json-endpoint to extract the sheet ID out of the url to plug into the DATA_URL const.

const DATA_URL = 'https://spreadsheets.google.com/feeds/list/1XJhbzcT_AubgnqAJRsbOEbMO3HPTybG3yNcX6i-BgH0/1/public/full?alt=json'

• Information about adding, editing and maintaining languages can be found in Language Translation

This started as a very lightweight, single page html file, and we've tried very hard to keep things as simple as possible.

1. Install node at the version specified in the .node-version file. If you use a version manager like nodenv or nvm, this should be detected automatically.
2. Install dependencies with npm

   npm install
   

3. Configure environment variables
4. Build and run the application with npm

   npm run dev
   

5. Visit the application in your browser at http://localhost:8080
6. Start building!

The application uses environmental variables to manage configuration between environments. These values are set in a .env file in the project root directory.

To set up a .env, copy the .env.example file, which lists needed configuration values. For example, in the Mac OS terminal:

cp .env.example .env

A set variable in the .env file will look like this:

SNOWPACK_PUBLIC_MAPBOXGL_ACCESS_TOKEN=1234

If you're a member of the Twin Cities Mutual Aid organization you can find the default values for the local development env file here:

https://github.com/Twin-Cities-Mutual-Aid/secrets/blob/master/.env

If not, you can ask for the most recent values of the configuration values from the Open Twin Cities slack #tc-aid-dev channel. They are pinned in the channel.

If you need to introduce a new environmental variable, please coordinate with developers in the #tc-aid-dev channel, add it to the .env.example file, and note it in your pull request.

To run a development server that will auto-reload on save, run this command from the project directory:

npm run dev

A server will run on http://localhost:8080

1. Add your dependency with npm install --save <dep>
2. Use your dependency with import <whatever> from '<dep>'
3. Run npm run snowpack install to vendor the dependency

1. Import the sheet from the dist folder like import '<dep>/dist/stylesheet.css
2. That's it.

1. Create a stylesheet in src/styles
2. Import the sheet either in the index or from whatever js file the styles apply to.

Images go in public/images and will be served under <url>/images/image_name.whatever

If you need to add some other kind of static file, it should go somewhere in the public folder.

Contributors to the project are expected to follow the Code of Conduct.