Getting Set Up

To set up the development environment, first clone the repo.

Frontend

Change into the frontend directory and run the following commands:

npm install npm run dev

Backend

First, you'll need to install pipenv and the project dependencies:

pip install pipenv pipenv install

Enable the virtual environment and run the flask application (defaults to port 5000):

flask run

What is CO-DE?

CO-DE is an open-source real-time collaborative code editor.

CO-DE is the current ongoing project for the Ship-In-30 project from David's Developer Safeplace Discord server.

Features

Yet to be discussed.

Tech Stack

CO-DE uses React with TypeScript (Vite) for the frontend website and uses Flask (Python) for the backend API and WebSocket infrastructure.

Contribution

Workflow

This project uses a 3 legged branching strategy with main being the production version of the code; the main branch reflects the current version that is currently live to the public. The development branch contains the active changes that are made by the engineers to implement new features or fixes; pull requests are needed to contribute to development with 2 approvals from other engineers.

When you are contributing to the project, you will need to create a new branch based on the development branch. Please format the branch with a prefix and a name that best describes the type of change being implemented these contain:

• feature/(New feature branches)
• fix/ (Fixes for branches)
• task/(Generic branches for mundane tasks, such as updating a lang file or dependencies)

Once you have selected the branch type please create a branch name as a suffix. For example, if you had a branch that implemented a login button on the home page you would call it feature/home-page-login-button

Upon completing your changes that are tested, please raise a pull request that merges into development, fill out the template and drop a link to the pull request in the "Ship-In-30" discussion channel. Upon review and approval, your changes will be submitted to the development branch. Then once the version is ready, it is released into production.

Tasks

Within this project, contributors can help to work on tasks. Tasks will be split into different issues. To claim a task, find the issue that includes your chosen task and comment that you would like to work on a specific part of the issue. It's key that we communicate with each other to create a more productive and efficient development environment. You can also mention that you've claimed a task in the discussion channel.

Make sure to read all the discussion within the issue to know what needs to be completed, there will be a checklist of tasks and who's working on them in the issue description to help things flow smoothly.

If you would like to unclaim a task, make sure to comment on the relevant issue to let everybody else know that the issue is open for contribution.

You can also collaborate on a task with another contributor, just let the rest of the team know in the issue discussion.