Custom Code Editor

This project is a React-based code builder that utilizes the Monaco Editor. It allows users to write and execute code snippets within a web browser. It uses Judge0 as a code execution system

Getting Started

Follow these instructions to get the project up and running on your local machine.

Prerequisites

Node.js installed on your machine npm or yarn package manager

Installation

Clone the repository to your local machine:

git clone https://github.com/DhanushNehru/CustomCodeEditor

• Note:- Please fill in the necessary keys in the .env file for successful code submissions

Without Docker

Install dependencies using npm or yarn: bash

npm install
# or
yarn install

To Start project

npm run start

With Docker

Prerequisites

Before starting with the project, ensure you have Docker installed. If not, follow these steps to install Docker:

Docker Installation

1. Windows:

   • Download Docker Desktop from Docker Hub.
   • Follow the installation instructions.

2. Mac:

   • Download Docker Desktop from Docker Hub.
   • Follow the installation instructions.

3. Linux:

   • Docker Engine installation varies by Linux distribution. Refer to Docker's official documentation for installation instructions specific to your Linux distribution.

To start the project using Docker Compose:

1. Build and run the project:

   #Detach mode
   docker-compose up -d
   

   docker-compose up
   

2. Access the project:

   • Once Docker Compose has started the containers, access the project using your web browser at http://localhost:3000.

3. Close project

   docker-compose down
   

Setting Up Judge0 with RapidAPI

1. Navigate to Judge0:

   • Start by going to the Judge0 page on RapidAPI.
   • Select the Basic Plan, which offers a limit of 50 requests per day.

2. Sign Up for the Basic Plan:

   • RapidAPI hosts Judge0, so you need to sign up for the Basic Plan on RapidAPI.
   • Follow the sign-up process to get started.

3. Access the RapidAPI Dashboard:

   • After signing up, go to the RapidAPI Dashboard.

4. Navigate to the API's Section:

   • In the navigation sidebar, you will see multiple endpoints such as Submissions, Statuses, Configuration, Information, and Languages.

5. Using the Submissions Endpoint:

   • For code submissions, go to the Submissions endpoint and then select Create Submission.
   • Here, you will find X-RapidAPI-Key, X-RapidAPI-Host, and the URL (url) needed for API calls. API-Key, API-Host and the URL is located below the "Code Snippets" section.

6. Copy Required Keys:

   • Copy the RAPIDAPI_HOST and RAPIDAPI_KEY values. These are necessary to perform API calls to the code execution system.
   • Ensure you have these keys saved as they will be used in your API requests.

By following these steps, you'll be able to set up Judge0 for code submissions using RapidAPI's infrastructure, enabling you to execute and evaluate code within your application.

Firebase Configuration

1. Create a Firebase account at firebase.google.com and click on "go to the console".
2. Go to Get Started by setting up a Firebase project or Add project if you've used Firebase before.
3. Enter a project name (e.g., CustomCodeEditor) then click Continue (disable Google Analytics (optional)),
4. Copy your SDK config snippet and then Create project.

-SDK config snippet should look like: const firebaseConfig = { apiKey: "AIzaSy....", authDomain: "your-app-name.firebaseapp.com", projectId: "your-app-name", storageBucket: "your-app-name.appspot.com", messagingSenderId: "1234567890", appId: "1:1234567890:web:abc123" };

5. After it's ready click on continue to proceed to the Firebase dashboard.
6. On the Project Overview page, click "+add app" and select "</>" Web option.
7. Enter an App nickname (e.g., CustomCodeEditor) and click on Register app then continue to console.
8. Go to the Build endpoint and select Authentication then in [sign in providers] select Google. Enable and select support email for the project then click on the save button
9. Create a .env file in your root directory and add these values:

REACT_APP_FIREBASE_API_KEY=""
REACT_APP_FIREBASE_AUTH_DOMAIN=""
REACT_APP_FIREBASE_PROJECT_ID=""
REACT_APP_FIREBASE_STORAGE_BUCKET=""
REACT_APP_FIREBASE_MESSAGING_SENDER_ID=""
REACT_APP_FIREBASE_APP_ID=""

GitHub Authentication Configuration

To enable GitHub authentication for the Custom Code Editor, follow these steps:

1. Enable GitHub Authentication in Firebase Console:

   • Go to your Firebase project in the Firebase Console.
   • Navigate to Authentication > Sign-in method.
   • Enable GitHub as a sign-in provider.
   • Note the Authorization Callback URL provided by Firebase, as you will need this for your GitHub OAuth App.

2. Register a New OAuth Application on GitHub:

   • Go to your GitHub Developer Settings.
   • Click on OAuth Apps and select New OAuth App.
   • Fill in the application details:
     • Application Name: Custom Code Editor
     • Homepage URL:
       • For local development, use http://localhost:3000
       • For production deployment, use your public URL (e.g., https://custom-code-editor.vercel.app/)
     • Authorization Callback URL:
       • Use the Authorization Callback URL provided by Firebase.
   • Click Register Application.

3. Retrieve GitHub Client ID and Client Secret:

   • Once the app is registered, you will see the Client ID and Client Secret in the GitHub OAuth App settings. Copy these values.

4. Add GitHub OAuth Credentials to Firebase:

   • Return to the Firebase Console and go back to the GitHub provider configuration.
   • Enter the Client ID and Client Secret from GitHub.
   • Save these settings.

5. Update Environment Variables:

   • Open your .env file in your project root and add the following:

     REACT_APP_GITHUB_CLIENT_ID=YOUR_GITHUB_CLIENT_ID
     REACT_APP_GITHUB_CLIENT_SECRET=YOUR_GITHUB_CLIENT_SECRET
     

   • Replace YOUR_GITHUB_CLIENT_ID and with the values you copied from GitHub.

Local Configuration

• Create a .env file in the root directory of your project if it doesn't already exist.
• You can copy content from .env.example to .env, you can run below command.

  cp .env.example .env
  

• Set the following environment variables in the .env file:

REACT_APP_RAPID_API_HOST=YOUR_HOST_URL
REACT_APP_RAPID_API_KEY=YOUR_SECRET_KEY
REACT_APP_RAPID_API_URL=YOUR_SUBMISSIONS_URL

# key for docker container name
COMPOSE_PROJECT_NAME=custom_code_editor

Replace YOUR_HOST_URL, YOUR_SECRET_KEY, & YOUR_SUBMISSIONS_URL with the appropriate values for your Rapid API and Judge0 API endpoints.

Server Setup Configuration

Create a .env file in the root directory of your project if it doesn't already exist. Set the JUDGE0_SUBMISSION_URL environment variable in the .env file. This variable should point to the URL of the Judge0 API endpoint you want to use for code execution. For example: plaintext

JUDGE0_SUBMISSION_URL=https://api.judge0.com/submissions

Replace https://api.judge0.com/submissions with the appropriate URL for your Judge0 API endpoint.

Running the Development Server Once the configuration is complete, you can start the development server to see the React code builder in action.

npm start
# or
yarn start

Open your web browser and navigate to http://localhost:3000 to access the application.

Usage

• Write your code in the Monaco Editor.
• Execute the code snippet by clicking the "Run" button.
• View the output in the console or output panel.

Important Information

Currently the project url is based out of the free version of judge0 this means at most one can have 50 requests per day.

Contributing

Contributions are welcome! Feel free to submit pull requests or open issues.

Contributors

---

Contributions are welcome. Drop a PR or reach out if you need any help!

GitAds Sponsored