Update: We're excited to announce that the public beta is just around the corner! 🎉 We've completely rebuilt progHours from the ground up.

A gamification-driven platform for competitive programmers.

progHours is an effort to combine problem-solving and gamification techniques to create a platform tailored for competitive programmers. This platform offers valuable analytics to foster user engagement and encourages them to compete with one another. It also helps coaches by offering valuable insights through comprehensive analytics to monitor and assess student progress.

This project is experimental and we are working to define and refine our goals. However, we have settled on the following common goals for the project:

• To provide comprehensive analytics on your problem-solving journey.
• To use gamification techniques, such as leaderboard, points and rewards, to engage students in competitive programming and compete with others.
• To provide coaches with valuable insights through comprehensive analytics to monitor and assess student progress.
• To foster a sense of community and shared accomplishment among students.
• To provide users with the opportunity to showcase their problem-solving skills to the recruiters.

Currently, we provide support for 14 Online Judges. Users can only track problems from supported online judges. We've created this library called @proghours/crawler, which is responsible for collecting problem and submissions data data from supported Online Judges. To learn more about it please explore the details here.

• Nx, TypeScript, React, Mantine, TanStack Query, Playwright
• NestJS, PostgreSQL, Prisma, Redis, BullMQ, Bull Board, Jest
• Docker, Docker Compose, Pino, Prometheus, Grafana, Loki

• NodeJS
• Docker

Begin by cloning this repository to your machine.

git clone git@github.com:naimulcsx/progHours.git

Install the dependencies.

npm install

Navigate to the progHours directory and run the components using docker-compose.

cd progHours
docker-compose -f docker-compose.yml up -d

If you are setting up for the first time, you need to run database migrations

npm run db:migrate

Launch the project by running the following command.

npm run dev

You can execute the end-to-end (E2E) tests using Playwright by running the following command in your terminal. The tests will run in a headless browser environment, and the test results will be displayed in the console.

nx run client:e2e

If you want to explore, run and debug tests with a time travel experience, you can use the Playwright's UI mode. o open UI mode, run the following command in your terminal:

nx run client:e2e --ui