Skip to content

Commit b288f6d

Browse files
authored
Merge pull request #35 from icep0ps/Issue-#34-update-readme-file
Issue #34 Update readme file (WIP)
2 parents 9562ab0 + c5d93bd commit b288f6d

File tree

1 file changed

+46
-34
lines changed

1 file changed

+46
-34
lines changed

README.md

+46-34
Original file line numberDiff line numberDiff line change
@@ -16,57 +16,69 @@ Code Racer is a multiplayer coding game where developers can compete against eac
1616
- Tailwind CSS: A utility-first CSS framework for rapid UI development.
1717
- TypeScript: A typed superset of JavaScript that provides enhanced tooling and developer productivity.
1818

19-
## Getting Started
19+
## Contribution
2020

21-
To get started with Code Racer locally, follow these steps:
21+
We welcome contributions from the community! If you'd like to contribute to Code Racer, please follow refer to [CONTRIBUTION.md](CONTRIBUTION.md), but we have these base guidelines:
2222

23-
Clone the repository:
23+
- Fork the repository.
24+
- Create a new branch for your feature or bug fix.
25+
- Make your changes and test thoroughly.
26+
- Commit your changes with clear commit messages.
27+
- Push your branch to your forked repository.
28+
Submit a pull request detailing your changes.
2429

25-
```bash
26-
git clone https://github.com/webdevcody/code-racer.git
27-
```
30+
Please ensure that your code adheres to the project's coding standards and conventions.
2831

29-
Navigate to the project directory:
3032

31-
```bash
32-
cd code-racer
33-
```
33+
## Getting Started
3434

35-
Install dependencies:
35+
### Prerequisites
3636

37-
```bash
38-
npm install
39-
```
37+
You will need to [install docker](https://example.com) on your local machine.
4038

41-
Updates schema to database
42-
```bash
43-
npx prisma db push
44-
```
39+
### Installation
4540

46-
Start the development server:
41+
To get started with Code Racer locally, follow these steps
4742

48-
```bash
49-
npm run dev
50-
```
43+
1. Clone the repo
44+
```sh
45+
git clone https://github.com/webdevcody/code-racer.git
46+
```
47+
2. Navigate to the project directory
5148

52-
Open your browser and visit http://localhost:3000 to see the application running.
49+
```sh
50+
cd code-racer
51+
```
5352

54-
## Configuration
53+
3. Install NPM packages
54+
```sh
55+
npm install
56+
```
57+
4. Generate a version of Prisma Client that is tailored to the models.
58+
```js
59+
npx prisma generate
60+
```
61+
5. Create .env file
5562

56-
Code Racer requires some configuration variables to run properly. Create a .env.local file in the root directory of the project and add the following variables:
63+
6. Copy and paste variables from `.env.example` into `.env`
5764

58-
## Contribution
65+
7. Update each variable in `.env` (optional).
5966

60-
We welcome contributions from the community! If you'd like to contribute to Code Racer, please follow refer to [CONTRIBUTION.md](CONTRIBUTION.md), but we have these base guidelines:
67+
8. Start a docker container for the database.
68+
```sh
69+
docker compose up
70+
```
71+
9. Once your database is ready, push your prisma schema to the database.
72+
```sh
73+
npx prisma db push
74+
```
75+
10. Finally start your dev server.
76+
```sh
77+
npm run dev
78+
```
6179

62-
- Fork the repository.
63-
- Create a new branch for your feature or bug fix.
64-
- Make your changes and test thoroughly.
65-
- Commit your changes with clear commit messages.
66-
- Push your branch to your forked repository.
67-
Submit a pull request detailing your changes.
80+
Open your browser and visit http://localhost:3000 to see the application running.
6881

69-
Please ensure that your code adheres to the project's coding standards and conventions.
7082

7183
## License
7284

0 commit comments

Comments
 (0)