A comprehensive, unified dashboard for analyzing Git repository commit logs and extracting detailed productivity metrics from both local repositories and GitHub.com repositories. This project provides a single, intelligent HTML dashboard that automatically adapts to its environment (offline/online) and delivers powerful repository analysis capabilities. Extract insights from commit logs, analyze productivity patterns, and visualize development metrics through an intuitive interface.
- Real-time data visualization with charts and graphs
- GitHub.com hosted index.html file (via https://kcoderva.github.io/CommitLog-ProductivityAnalyzer/)
- Responsive design for all devices
- Three main analysis sections:
- Repository Summary: High-level overview and statistics
- Detailed History: Comprehensive commit timeline
- Productivity Metrics: In-depth analysis and trends
- Local Git Repositories: Direct analysis of local
.gitfolders (offline mode) - GitHub Repositories: Remote analysis via GitHub API (online/offline modes)
- Enhanced Git Log Parsing: Accurate statistics from Git log files with
--statoutput - Automatic Detection: Smart environment detection for seamless operation
- Real Statistics: Precise file changes, additions, and deletions matching
git log --statoutput
- Commit frequency and patterns analysis
- File impact analysis (additions, deletions, modifications)
- Line change statistics and trends
- Developer productivity insights
- Time-based activity patterns
- Repository growth tracking
- Unified Entry Point: Single
index.htmlfor all environments - Offline Mode: Full functionality for local repositories
- GitHub Pages Ready: Optimized for web hosting
- Cross-Platform: Works on Windows, macOS, Linux
CommitLog_ProductivityDashboard/
├── 📄 index.html # Unified entry point with environment detection
├── 📄 README.md # Project documentation
├── 📄 LICENSE # Apache 2.0 license
├── 📄 CHANGELOG.md # Version history and changes
├── 📄 .gitignore # Git ignore patterns
├── 📄 *.code-workspace # VS Code workspace configuration
├── 📁 config/ # Environment configurations
│ ├── offline-config.js # Settings for offline mode
│ └── online-config.js # Settings for online/hosted mode
├── 📁 src/ # Source code
│ ├── 📁 js/ # JavaScript modules
│ │ ├── 📁 core/ # Core functionality
│ │ │ ├── data-processor.js # Data processing and analysis
│ │ │ ├── git-analyzer.js # Local Git repository analysis
│ │ │ └── github-api.js # GitHub API integration
│ │ ├── 📁 ui/ # User interface
│ │ │ ├── dashboard.js # Main dashboard controller
│ │ │ └── charts.js # Data visualization
│ │ └── 📁 utils/ # Utility functions
│ │ ├── file-handler.js # File system operations
│ │ └── helpers.js # General helper functions
│ ├── 📁 css/ # Stylesheets
│ │ ├── main.css # Core styles and reset
│ │ ├── dashboard.css # Dashboard-specific styles
│ │ └── responsive.css # Mobile and responsive design
│ └── 📁 assets/ # Static assets
│ ├── 📁 images/ # Images and screenshots
│ ├── 📁 icons/ # Icon files (SVG, PNG)
│ └── README.md # Asset usage guidelines
├── 📁 docs/ # Documentation
│ ├── user-guide.md # User manual and instructions
│ └── api-documentation.md # Developer API reference
└── 📁 tests/ # Testing framework
├── 📁 unit/ # Unit tests
├── 📁 integration/ # Integration tests
└── README.md # Testing documentation
The index.html file is the single entry point that automatically detects its environment and adapts accordingly:
-
🏠 Local/Offline Mode (
file://protocol)- Enables local Git repository folder selection
- Full offline functionality without internet dependency
- Direct filesystem access for
.gitrepository analysis
-
🌐 GitHub Pages Mode (
.github.iodomains)- Optimized for GitHub Pages hosting
- GitHub repository URL analysis via API
- Responsive web interface
-
☁️ Online Mode (other web servers)
- Standard web hosting compatibility
- GitHub API integration for remote repositories
- Cross-origin request handling
- Clone or Download: Get the repository to your local machine
git clone https://github.com/KCoderVA/CommitLog_ProductivityDashboard.git
- Open Dashboard: Double-click
index.htmlor open in your browser - Analyze Repositories:
- Local: Click "Select Local Git Repository" to browse for a
.gitfolder - Remote: Enter any GitHub repository URL (e.g.,
https://github.com/user/repo)
- Local: Click "Select Local Git Repository" to browse for a
- View Results: Explore the generated analysis in the dashboard sections
- Visit Website: Go to the hosted version URL
- GitHub Analysis: Enter a GitHub repository URL for analysis
- Explore Data: View comprehensive productivity metrics and visualizations
Note: Local repository analysis is automatically disabled in online mode for security
- HTML5: Semantic markup with accessibility features
- CSS3: Modern styling with Flexbox/Grid and responsive design
- Vanilla JavaScript (ES6+): Modular architecture without framework dependencies
- Dynamic Module Loading: Environment-specific script loading
- Progressive Enhancement: Core functionality works everywhere
- Mobile-First Design: Responsive across all device sizes
- Modular Architecture: Separation of concerns with clean interfaces
- Environment Agnostic: Single codebase adapts to deployment context
- Performance Optimized: Minimal dependencies and efficient loading
- Fork the Repository on GitHub
- Clone Your Fork to your local machine
- Create a Feature Branch:
git checkout -b feature/your-feature-name - Make Your Changes following the project coding standards
- Test Thoroughly using both offline and online modes
- Submit a Pull Request with a clear description
- Apache 2.0 License Headers: Include in all new source files
- JSDoc Comments: Document all functions and classes
- Semantic Versioning: Follow SemVer for version updates
- Conventional Commits: Use standardized commit message format
- Responsive Design: Ensure mobile compatibility for UI changes
- Temporary Files Policy: Always add temporary development files to .gitignore (see Development Guidelines)
- VS Code Workspace: Pre-configured development environment
- Git: Version control with semantic versioning
- Testing Framework: Unit and integration test structure
- Documentation: Comprehensive docs for users and developers
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Copyright 2025 KCoderVA
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Created by KCoderVA - GitHub Profile