Calendar

A HackerRank sample repo for personal scheduling and team coordination.

Built With

• React 19 and Vite 8 for the frontend
• Bun for JavaScript workspace installation
• Python 3.12, Django 5.1, and Django REST Framework for the HTTP API
• MongoDB and MongoEngine for persistence without the Django ORM
• Feature schemas and shared validation utilities for request validation
• PyJWT and bcrypt for authentication

Project Structure

.
├── backend/                     # Django API, business logic, and MongoDB persistence
│   ├── apps/                    # Product domains and API flows
│   ├── calendar_backend/        # Django settings and URL composition
│   ├── scripts/                 # Deterministic seed data
│   └── public/                  # Backend-served local media
├── frontend/
│   ├── src/features/            # Product views and interactions
│   ├── src/shared/              # API client, reusable controls, and utilities
│   └── public/                  # Local static media
├── docs/                        # HackerRank Code Repo guidelines
├── skills/validate/             # Read-only repository validation skill
├── .vscode/launch.json          # Django debugger configuration
├── hackerrank.yml               # HackerRank install and run configuration
└── setup.sh                     # Python, MongoDB, and seed setup

Getting Started

Prerequisites

• Bun 1.3 or later
• Python 3.12
• uv
• MongoDB 8.0 or later on 127.0.0.1:27017

Development Setup

1. Clone the repository.

   git clone https://github.com/ProblemSetters/coderepo-react-django-calendar.git

2. Open the project directory.

   cd coderepo-react-django-calendar

3. Install the pinned JavaScript workspace.

   bun install

4. Start the complete application.

   bun start

   Startup prepares the Python environment, checks MongoDB, restores the seeded baseline, and launches the frontend and backend.

5. Open http://localhost:3000 and sign in.

   Email: alex.morgan@calendar.com
   Password: password123
   

   Choose any seeded profile to enter the calendar workspace.

The frontend runs on port 3000, the API runs on port 8000, and health is available at http://localhost:8000/api/v1/health.

Commands

Command	Purpose
bun start	Seeds MongoDB and starts Django and Vite together.
bun run seed	Restores the deterministic MongoDB baseline.
bun run dev:backend	Starts only the Django API on port 8000.
bun run dev:frontend	Starts only Vite on port 3000.

HackerRank installs the application with bun install && bash setup.sh --seed and runs it with bun start.

Validate the Repository

Follow the HackerRank Code Repo Guidelines while creating the application to keep its structure, setup, and product behavior aligned.

When complete, validate the repository in Codex or Claude Code with this prompt:

Read and follow skills/validate/SKILL.md to validate this complete Code Repo application against docs/HackerRank-Code-Repo-Guidelines.md. Run the in-scope static, install, build, start, API, and MongoDB checks, then write the report outside the repository.