Discover open-source projects, connect with experienced maintainers, and collaborate with a community of passionate contributors. Join over 200+ registered users who are already making a difference
Check out the web app π : https://projectmate.net/
As a community, we always encourage people to share their thoughts and ideas. Do you want to talk to us? Join and Follow our Discord server and Twitter page β¬οΈ
Figma design:
Prerequisites
Before getting into it, make sure you have yarn and prisma installed.
Fork the project π§
Clone the project by running the following command on the terminal π½
git clone https://github.com/<your-github-username>/projectmate.git
Go into the project directory π½
cd projectmate
Create an .env
file from the .env.template
file (copy everything in the .env.template
file and put it in the .env
file with appropriate values) π
MONGODB_URI
is the connection string
which you'll get from mongodb for reference.NEXTAUTH_SECRET
Just pass any random string
or you can quickly create a good value on the command line via this openssl command
.
openssl rand -base64 32
Install all the dependencies β
yarn
Synchronize your Prisma schema with your database schema π
yarn prisma db push
Insert required data to your database β
yarn prisma db seed
Start the application development server π
yarn run dev
NOTE: Docker set up is highly recommended mainly on linux systems due to possible performance issues on other platforms.
Fork the project π§
Clone the project by running the following command on the terminal π½
git clone https://github.com/<your-github-username>/projectmate.git
Go into the project directory π½
cd projectmate
Create an .env
file from the .env.template
file (copy everything in the .env.template
file and put it in the .env
file with appropriate values) π
MONGODB_URI
is the connection string
, in this case your connection string should look exactly like this mongodb://root:root@mongo:27017/projectmate?authSource=admin
NEXTAUTH_SECRET
Just pass any random string
or you can quickly create a good value on the command line via this openssl command
.
openssl rand -base64 32
Build docker containers π½
docker compose build
Start containers in a background π½
docker compose up -d
Synchronize your Prisma schema with your database schema π
docker compose exec web yarn prisma db push
Insert required data to your database β
docker compose exec web yarn prisma db seed
You can access logs from web or mongo container by docker compose logs e.g:
docker compose logs web -f
If you want to stop containers just run:
docker compose stop
Or if you want to stop and remove containers, networks:
docker compose down
NOTE: If you want to add new package, you must use
docker compose exec web yarn add [package]
Then (also if you pulled branch with changes to package.json) rebuild containers:
docker compose up --build -d
You cannot perform
yarn build
from your local machine - you need to use:docker compose exec web yarn build
Any contributions you make are truly appreciated, go to our CONTRIBUTING.md file for more information on how to contribute.
View CODE_OF_CONDUCT.md
Don't forget to support us by leaving a star β
projectmate is licensed under the MIT License - see the LICENSE file for the details.