freeCodeCamp Developer Quiz

Learn to Code RPG Main Menu

The developerquiz.org website is the companion to Learn to Code RPG Game, a visual novel game developed by freeCodeCamp to help you learn how to code. 😺

developerquiz.org hosts all 1200+ multiple choice questions featured in the game on the following topics:

HTML 🖊️
CSS 🎨
JavaScript ⚙️
Linux 🐧
Python 🐍
Git 📁
SQL 📊
IT 🖥️
Quality Assurance ✅
Agile ⏩
Security 🔒
and Computer Science Concepts 🤖

All questions are beginner friendly and approachable to all levels, so they are ideal for refreshing your programming knowledge.

If you are brand new to programming, learn to code for free and start your programming journey with freeCodeCamp.

freeCodeCamp creates thousands of articles, videos and courses on a variety of coding topics.

All of the helpful and thoughtful resources are made possible by the generous donations of kind people.

Have a look here at the different ways you can support our non-profit's mission and make tech education accessible to all.

How to work on the project using Gitpod

Gitpod is an online environment, where you can work on projects without installing anything on your machine. To setup the Developer Quiz Site with Gitpod, visit this link

How to run the project locally

Here are directions on how to fork the freeCodeCamp/Developer_Quiz_Site repository:
https://docs.github.com/en/get-started/quickstart/fork-a-repo

In the command line:

Clone the repo by typing git clone https://github.com/YOUR-GITHUB-USERNAME/Developer_Quiz_Site.git
Then type cd Developer_Quiz_Site to go into the project's directory.
Install dependencies with pnpm install
Run the project with pnpm start
Have fun 🚀

Using Docker Compose

Ensure you have Docker and Docker Compose installed on your machine.

Clone the repo by typing git clone https://github.com/YOUR-GITHUB-USERNAME/Developer_Quiz_Site.git
Then type cd Developer_Quiz_Site to go into the project's directory.
Run the project with docker-compose up
Access the project at http://localhost:3000 or via the host network IP address, typically http://HOST_IP_ADDRESS:3000
Have fun 🚀

How to contribute

This open source project is a work in progress and ever evolving.

We welcome all contributions, suggestions and ideas for improvement from the community.

You can contribute by fixing bugs in the codebase, proposing new features or adding new questions.

Make sure to first read through the Code of Conduct.

Then, read through our Contributing Documentation.

How to run the unit tests

Once you are finished making changes, you will need to run the test suite to make sure your code doesn't break anything. Here is terminal command for running tests: pnpm test (or, even shorter: pnpm t )
alternativetly (and also cool!) - you can install vscode vitest extension

How to run the e2e tests

This repo uses Playwright for end-to-end testing.

To run the tests in UI mode, run:
```
pnpm run e2e:ui
```
To run the tests in headless mode, run:
```
pnpm run e2e:ci
```

Note: e2e tests cannot be run in Gitpod environment.

How to report bugs

Found a bug while playing?

Read through this helpful article on how to report bugs.

Then, report them by opening a GitHub Issue.