Game Worker Solidarity is mapping and documenting collective movements by game workers striving to improve their working conditions. We're collecting materials created by workers for these movements and aim to document the longer history of resistance in the industry which goes back to its formation.
This repository is for a website backed by a database of events that can be freely searched by location, type of action, and numbers involved for events like the creation of trade union branches, new contracts, strikes, protests, social media campaigns, etc.
Where possible, we'll also interview and record oral histories with participants of these movements to produce a living resource that can help support and inspire more organising in the games industry.
Do you have any information to share with us that we can add to the timeline? Get in touch!
Check out this early stage, highly WIP documentation for the overall system. Later we will transpose that content to this README file.
First, download the code from github (e.g. git clone).
You will need to copy .env.template to .env.local and fill out the required env variables.
- The Airtable private API key can be found here, in your account settings.
To run the system locally, on your machine you will need:
node(recommend installing and managing this vianvm)- ideally also
yarn, because we pin specific versions of package dependencies using yarn (see./yarn.lock)
Install the required package dependencies:
yarn
# or
npm installThen you can run the development server:
yarn dev
# or
npm run devOpen http://localhost:3000 with your browser to see the result.
This is a Next.js project bootstrapped with create-next-app. To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can start editing the page by modifying pages/index.js. The page auto-updates as you edit the file.
API routes can be accessed on http://localhost:3000/api/hello. This endpoint can be edited in pages/api/hello.js.
The pages/api directory is mapped to /api/*. Files in this directory are treated as API routes instead of React pages.
In development we've been generating schemas from typescript interfaces, to help smooth out API responses. When things aren't as expected, they don't show up.
To add to the schema, add interfaces to types.ts.
To regenerate the schema (at schema.ts):
yarn generateschemaThis repo auto-deploys to Digital Ocean.
Cloudinary is used as a public CDN for Airtable images. Here's how it works:
- The
/api/syncToCDNendpoint is responsible for refreshing thecdn_urlsto sync Airtable's private attachments to the public CDN and then store the public URLs back in Airtable for serving in the frontend. - The hidden
cdn_urlscolumn which stores data about the publicly viewable URLs should not be edited manually. - Whenever an Airtable record is updated, a webhook will trigger the re-sync. A Github action regularly triggers maintenance script, which will create/refresh the managed webhook to the Airtable.
- The webhook management script requires an access token in the env (
AIRTABLE_API_KEY) configured via this URL as follows:
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent