Overview

This is the repo for the OpenOUSD project located at openousd.org. Read the front page for a description of the project. All contributors are volunteers and the project has no private or public funders.

We welcome new team members!

Technology

OpenOUSD uses several technologies:

• Gatsby, a static site generator built on React
• Postgres to store public datasets
• Node.js to serve that data as JSON through a light API (see openousd-api)

Since this is a static site, the data is fetched once and stored in static JSON files in the /data directory. The live site does not require any API or database.

Setting Up The Project Locally

1. Run git clone [email protected]:openoakland/openousd-site.git
2. cd openousd-site
3. npm install (if you don't have npm, install node via the node installer or homebrew (macOS) or nvm if you work on several node projects)
4. Run npm install -g gatsby-cli to install the gastby command line tool globally
5. Ask a member of the project team on OpenOakland Slack for a Contentful API token. Insert the token into this command and run it to create a file and populate the token as an environment variable.

echo "CONTENTFUL_ACCESS_TOKEN={insert the token here and remove brackets}" > .env.development

6. gatsby develop

Go to http://localhost:8000 in your browser

Deploying

Staging

Anyone with write privileges to the repository should be able to push a branch to staging.openousd.org.

To do that, run this command from your branch:

npm run deployStaging

This runs some commands listed in package.json which essentially:

1. run a production gatsby build
2. creates the CNAME file for GitHub Pages
3. Pushes to the gh-pages branch using gh-pages

Promote Staging to Production

Only a few members of the group and OO GitHub admins can publish staging.openousd.org to openousd.org.

Please be careful. If you have those permissions, you can run this command from any branch:

npm run promoteStaging

This probably needs to be brought into a proper deploy system, but for now this runs promote_staging.sh which essentially:

1. git fetches the latest from GitHub
2. checks out the gh-pages branch
3. replaces the staging CNAME file with the production one
4. pushes the files to openousd-site-prod master repo
5. goes back to the branch you started in