🏃‍♀️ Speed Run Ethereum

Warning

This is the codebase for SpeedRunEthereum v1 (live until April 2025) Visit https://github.com/BuidlGuidl/SpeedRunEthereum-v2/ for the new & live version.

Speed Run Ethereum aims to provide a structured learning path for onboarding developers to Ethereum.

🏃‍♀️Ethereum Dev Speed Run with a framework for submitting challenges, get feedback from ethereum builders, and in the process unlocking new challenges and proof of completion.

---

Project setup

Get the project code:

git clone [email protected]:BuidlGuidl/SpeedRunEthereum.git

cd SpeedRunEthereum

Install dependencies:

yarn install

Start the backend service:

yarn backend

In a new terminal, start the frontend:

yarn start

At this point, you should have the app available at http://localhost:3000. By default, a locale JSON file (packages/backend/local_database/local_db.json) is used as the database. This is intended for testing and demo usage. In order to set it up for production usage, we provide a Firebase database adaptor. You can also easily create your own database adapter (check packages/backend/services/db.js).

---

Firebase Setup (optional)

If you want to use Firebase (firestore) for data storage, you'll need to create a Firebase project and download the service account key configuration. You can generate and download the service account file at https://console.cloud.google.com/ by 1.) select your Firebase project, 2.) go to IAM & Admin > Service Accounts, 3.) create a service account or click one that is already created, 4.) go to keys of that account, and 5.) Add Key > Create key and select a JSON key type.

Then you will have to create a .env file in packages/backend/ with DATABASE_SERVICE=firebase and add the full path to the service account file in GOOGLE_APPLICATION_CREDENTIALS (see a sample here packages/backend/.env.sample).

Then re-run:

yarn backend