Skip to content

WomenInSoftwareEngineeringJP/speak-her-db

Repository files navigation

Website GitHub Netlify Status W3C Validation GitHub contributors Twitter Follow

SpeakHer

https://speakher.jp/

SpeakHer is a database of women public speakers in Japan. A common excuse we hear from conference and event organizers is how they can't find any women. Let's banish that excuse. Please join our list and make sure that women get fair representation for public speaking engagements.

The purpose of gathering this information is so that event organizers can easily search for women speakers and that fellow speakers can connect with and support each other

This project is maintained by Women Who Code Tokyo

GitHub Org's stars Twitter Follow Open Collective backers and sponsors

How to Contribute

Please check out our contributor guidelines and read the Wiki to understand how the code works.

Code of Conduct

All contributors to this repository must follow the Code of Conduct. Thank you for helping us build an inclusive open-source project.

Running the code

Requirements:

Database connection

This project uses Airtable as a data source. Follow these steps to configure a database on your local environment:

  1. Go into the web directory: cd web
  2. Make a copy of .env.sample and rename it to .env.development
  3. Register as a contributor of the Airtable development database clicking here
  4. Get your Airtable API Key on your Airtable account
  5. Get the development database ID on the Dev DB Docs
  6. Edit .env.development to add your AIRTABLE_API_KEY and the development AIRTABLE_DB_ID

.env.development

NODE_ENV=development
VUE_APP_AIRTABLE_DB_ID=[dev database ID here]
VUE_APP_AIRTABLE_API_KEY=[your api key here]
AIRTABLE_DB_ID=[dev database ID here]
AIRTABLE_API_KEY=[your api key here]

You can change other DB configs on /plugins/airtable.js.

Further information on the database schema and query documentation here (login with the account you registered on step 2).

Running the app

cd web
yarn install
yarn serve

Access it on localhost:8080 on your browser.

Useful commands

Install dependencies

yarn install

Compiles and hot-reloads for development

yarn run serve

Compiles and minifies for production

yarn run build

Lints and fixes files

yarn run lint

Running tests

yarn run test

Run unit tests

yarn run test:unit

Run E2E tests with Cypress

After running the server on port 8080, in a separate tab, fire up cypress with:

yarn e2e

Testing production on local environment

If you have access to the production database, you can setup your production config on .env.production and run the app in production mode using the command yarn serve --mode production