ResearchEquals.com

ResearchEquals.com is a research module server, where researchers can publish building blocks of research and link them together in chronological order.

ResearchEquals is deployed on a continuous basis using Flightcontrol and translated on a continuous basis using Weblate.

Code of Conduct

You're welcome to our house in good faith – read our code of conduct for the house rules applicable to all contributions. Good intent does not excuse behavior in violation of these house rules (read more about why here).

Our house may be different from yours, and if you find any of this unagreeable, that's perfectly okay, and we ask you respectfully to not contribute.

Development

Development for this project uses node version 18. Please make sure you are using this version.

Please clone the repository and make sure you have BlitzJS installed:

## Install BlitzJS if you don't have it
npm install -g blitz --legacy-peer-deps

## Clone repository
git clone https://github.com/libscie/researchequals.com
cd researchequals.com

## Install dependencies
npm install

Before you can run a local development version, please ensure you have a Postgres server you can create databases on. Add your preferred route to .env.local as such:

DATABASE_URL=postgres://myuser:mypassword@localhost:5432/researchequals-dev

If you don't have postgres running, you can use the docker-compose file which will set one up:

docker-compose up

To get a fully functional development environment you need to add the environment variables as listed in .env.example. For developing locally, you need to add these variables to two .env files: (1) .env.local and (2) .env.test.local. Please note most of these services are freemium and you can sign up for a free account.

You can migrate and seed your database with

npx prisma migrate dev

blitz db seed

You can start your development environment with

npm run dev

which defaults to localhost:3000.

Submitted pull requests are automatically deployed using Heroku (self-destroyed after 24 hours).

Testing Stripe

If you want to develop the Stripe payment pipeline, you can activate using the following command (after installing the stripe-cli):

stripe listen --forward-to localhost:3000/api/stripe_webhook

Project Structure

All website pages are in /pages, database schemas, migrations, and seeds in /db, translations in /langs, mailer functions in /mailers, public files and images in /public, and tests in /test.

Maintainers :building_construction:

These people spend their time making sure the platform is operational and improves over time. They're always available for messages of appreciation :purple_heart:

_{Nami Sunami}

_{Chris Hartgerink}

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_AerynThrace 📓	_AnnaVantVeer 🤔	_{Asura Enkhbayar} 📓	_{Cassandra Gould van Praag} 🐛	_{Dan Rudmann} 🖋 🧑‍🏫 👀 🤔	_{Daniel Lombraña González} 📓	_{Daniel Nüst} 🤔
_Dependabot 🚧	_{Egon Willighagen} 📓 💡 🤔 💻	_{Esther Plomp} 📓	_{Gianluca Della Vedova} 🤔	_{Hanne Oberman} 🤔	_{Jazelle Maira Carillo} 💻	_{Jeffrey Spies} 🐛
_{Jessie L Oliver} ️️️️♿️	_Kasia 🌍	_{Kaveh Bazargan} 🐛	_{Mario Angst} 🤔	_{Marton Kovacs} 📓	_{Mina Abadir} 🚇	_{Nami Sunami} 🌍 🎨 🤔 🐛 💻 📖
_{Nathan Sainsbury} 🐛	_{Nathan Sainsbury} 💻 🎨	_{Patrick Sobrak-Seaton} 🎨 ⚠️ 📓	_{Robbie van Aert} 🐛	_{Sam Teplitzky} 📓	_{SarahanneMField} 📓	_Simon 🐛
_Solana 🌍	_{Stefan Vriend} 🐛	_{Thomas F. K. Jorna} 🐛	_{Vinodh Ilangovan} ️️️️♿️	_{Weblate (bot)} 🌍	_ab-ioi 📓	_coglebed 🌍
_{dvanravenzwaaij} 🖋	_senficon 🤔