{"id":25221566,"url":"https://github.com/robmcelhinney/codetime","last_synced_at":"2026-04-28T08:03:00.041Z","repository":{"id":275854031,"uuid":"925875480","full_name":"robmcelhinney/codeTime","owner":"robmcelhinney","description":"web application that visualizes your GitHub activity based on commit timestamp to a repo's default branch","archived":false,"fork":false,"pushed_at":"2025-11-16T10:29:49.000Z","size":42691,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-16T12:16:15.280Z","etag":null,"topics":["github","visualization"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robmcelhinney.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-02T00:20:04.000Z","updated_at":"2025-11-16T10:29:47.000Z","dependencies_parsed_at":"2025-02-04T23:28:37.788Z","dependency_job_id":"7f0322aa-f980-4666-8d70-cb4c3a9c2b73","html_url":"https://github.com/robmcelhinney/codeTime","commit_stats":null,"previous_names":["robmcelhinney/codetime"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/robmcelhinney/codeTime","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmcelhinney%2FcodeTime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmcelhinney%2FcodeTime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmcelhinney%2FcodeTime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmcelhinney%2FcodeTime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robmcelhinney","download_url":"https://codeload.github.com/robmcelhinney/codeTime/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robmcelhinney%2FcodeTime/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32371673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","visualization"],"created_at":"2025-02-10T22:52:49.355Z","updated_at":"2026-04-28T08:03:00.023Z","avatar_url":"https://github.com/robmcelhinney.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **CodeTime 📊**\n\n**CodeTime** is a web application that visualizes your GitHub activity based on **commit timestamps** to a repo's default branch. It helps you analyze when you're most active on GitHub and provides insights into your coding habits.\n\n---\n\n## **Features 🌟**\n\n-   **Commit Heatmaps** – Visualize your GitHub commit patterns by hour and weekday.\n-   **Timezone Aware** – Automatically converts commit times to your local timezone.\n-   **Custom Date Range** – Analyze commits for any time period, defaulting to the past year.\n-   **Fast Caching (Development Mode)** – Caches GitHub data locally to avoid hitting API limits.\n\n---\n\n## **Installation \u0026 Setup 🛠️**\n\n1. **Clone the repository**:\n\n    ```bash\n    git clone https://github.com/robmcelhinney/codeTime.git\n    cd codeTime\n    ```\n\n1. **Install dependencies**:\n\n    ```bash\n    npm install\n    ```\n\n1. **Run the development server**:\n\n    ```bash\n    npm run dev\n    ```\n\n    Open [http://localhost:3000](http://localhost:3000) in your browser.\n\n1. **Build for production**:\n    ```bash\n    npm run build\n    npm start\n    ```\n\n---\n\n## **Usage 📖**\n\n### **1️⃣ Enter Your GitHub Username**\n\n-   Type your GitHub username into the input field.\n-   Click **Go** to fetch your commit history.\n\n### **2️⃣ Choose a Date Range**\n\n-   Select a **start date** to analyze commits from that point onward.\n-   Defaults to **1 year ago** if no date is selected.\n\n### **3️⃣ View Commit Activity**\n\n-   **Hourly Heatmap**: Displays commit frequency for each hour of the day.\n-   **Weekday Heatmap**: Shows which days you commit the most.\n\n---\n\n## **API \u0026 Caching 🔥**\n\nThe project fetches commit data using the **GitHub Search API**. To avoid hitting API limits, commits are **cached locally in development mode**.\n\n-   **Cache Enabled (`USE_CACHE=true`)** → Saves commit data in the `cache/` directory.\n-   **Cache Disabled (`USE_CACHE=false`)** → Always fetches fresh data from GitHub.\n\nYou can manually delete cache files in the `cache/` folder if needed.\n\n---\n\n## **Development 🧑‍💻**\n\n### **Code Structure**\n\n-   **`pages/`** – Next.js pages, including `/api/github.js` for backend API requests.\n-   **`components/`** – React components for charts and UI elements.\n-   **`cache/`** – Stores cached GitHub data (used in development mode).\n\n---\n\n## Screenshot\n\n![screenshot](img/screenshot.png)\n\n---\n\n## **License 📜**\n\nThis project is licensed under the **MIT License**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobmcelhinney%2Fcodetime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobmcelhinney%2Fcodetime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobmcelhinney%2Fcodetime/lists"}