theunitedeffort / theunitedeffort.org

The United Effort Organization website

Home Page:https://theunitedeffort.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Website for The United Effort Organization

https://theunitedeffort.org

Netlify Status

This site is also deployed on a preview URL for the purposes of checking content updates before they are deployed to the production site.

https://preview-ueo.netlify.app/ (Preview site)

Netlify Status

What is this site?

A collection of curated resources and a searchable database of collated affordable housing to assist those in Santa Clara County, USA

Data source

Data for these page views are drawn from Airtable via the Airtable API. To access the data, the site requires readonly access to Airtable via the appropriate Airtable base IDs and the Airtable API key. Provide these via environment variables:

  • AIRTABLE_API_KEY
  • AIRTABLE_BASE_ID=apphE4mk8YDqyHM0I
  • AIRTABLE_RESOURCES_BASE_ID=app1uIzz4pZe9IM21

Permissions to the Airtable bases can be granted by the adminitrators of the UEO base and the UEO Resource base. Once you have at least read access to the bases, you can get a value for AIRTABLE_API_KEY by generating an Airtable personal access token with data.records:read scope on both the UEO Housing Database and the UEO Resources Database.

Public transit data is also drawn from 511 SF Bay. If you want this data in your development site, you will need to provide an addtional optional environment variable:

  • SF_BAY_511_API_KEY

You can get such an API key by requesting it from 511.

Local development

Prerequisites

This project requires Node.js and npm. It's recommended that you use a node version manager such as nvm to install Node.js and npm. You can find detailed instructions for installation via a node version manager on the npm website or use the simplified instructions below.

Linux and Mac (Full instructions)

Install nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

Then close and re-open your terminal window. Next, install Node.js using nvm:

nvm install node

Download and run the latest nvm-setup.exe

Open a terminal as Administrator, then install Node.js:

nvm install latest
nvm use latest

Environment setup

To make your own copy of this site and begin development, follow these instructions:

Clone this repo

git clone https://github.com/theunitedeffort/theunitedeffort.org

Install dependencies

cd theunitedeffort.org
npm install

Install Netlify CLI

npm i -g netlify-cli

Store environment variables

First store the AIRTABLE_BASE_ID variable:

echo AIRTABLE_BASE_ID=apphE4mk8YDqyHM0I > .env

Next, store the AIRTABLE_API_KEY variable as your personal access token. Since everyone's Airtable personal access token is different, you will have to modify the below command to replace {YOUR_ACCESS_TOKEN} with your actual access token. For example, if your Airtable personal access token was abc123, then the command would be echo AIRTABLE_API_KEY=abc123 > .env

echo AIRTABLE_API_KEY={YOUR_ACCESS_TOKEN} > .env

Run local development build and server

netlify dev

Hosting and Deployment

The site is hosted on Netlify and is managed in a Netlify team called United Effort Org.

After setting up the site with Netlify, you will have a CI/CD pipeline set up to deploy on each push to your production git branch. Pushing changes to prod will automatically build and deploy the site.

Planning and contributing

We collect and prioritise our efforts in GitHub issues, arranged into Milestones and coordinate our efforts on those issues in a GitHub Project. To avoid duplicating effort, you should capture your tasks in an issue and mark yourself as the assignee.

About

The United Effort Organization website

https://theunitedeffort.org


Languages

Language:HTML 89.6%Language:JavaScript 7.7%Language:Liquid 2.0%Language:SCSS 0.7%