Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jagoda11/github-insights-dashboard

πŸš€ A GitHub Insights Dashboard that visualizes user activity, including πŸ“Š commit frequency, πŸ–₯️ programming languages used, and πŸ“ commit details. Built with βš›οΈ React, 🟦 TypeScript, and πŸ“ˆ Chart.js for a robust and user-friendly experience.
https://github.com/jagoda11/github-insights-dashboard

babel cicd eslint formating frontend gh-pages github-actions github-api github-authentication husky jest quickstart react tailwindcss test ts-morph typescript

Last synced: about 14 hours ago
JSON representation

πŸš€ A GitHub Insights Dashboard that visualizes user activity, including πŸ“Š commit frequency, πŸ–₯️ programming languages used, and πŸ“ commit details. Built with βš›οΈ React, 🟦 TypeScript, and πŸ“ˆ Chart.js for a robust and user-friendly experience.

Awesome Lists containing this project

README

        

# πŸš€ GitHub Insights Dashboard

[![Deploy to GitHub Pages](https://img.shields.io/badge/GitHub%20Pages-View%20Live-brightgreen)](https://jagoda11.github.io/github-insights-dashboard/)
![License: MIT](https://img.shields.io/badge/license-MIT-pink)
![Open Issues](https://img.shields.io/github/issues/Jagoda11/github-insights-dashboard?style=flat-square&color=orange)
![Last Commit](https://img.shields.io/github/last-commit/Jagoda11/github-insights-dashboard/main?style=flat-square&color=yellow)
![Build Status](https://github.com/Jagoda11/github-insights-dashboard/actions/workflows/πŸš€ci.yml/badge.svg?branch=main)
![React](https://img.shields.io/github/package-json/dependency-version/Jagoda11/github-insights-dashboard/react?label=React)
![TypeScript](https://img.shields.io/github/package-json/dependency-version/Jagoda11/github-insights-dashboard/dev/typescript?label=TypeScript)
![Build Status](https://github.com/Jagoda11/github-insights-dashboard/actions/workflows/⬆️npm-upgrade.yml/badge.svg?branch=main)

## πŸ“ Summary

An interactive dashboard to visualize GitHub user activity, including commits, programming languages, and repository statistics.

- React βš›οΈ: For building user interfaces.
- Babel 🐡: Transpiling JavaScript.
- TypeScript πŸ”΅: Type-safe coding.
- ESLint πŸ› οΈ: Linting and code quality.
- Prettier πŸ–‹οΈ: Code formatting.
- Jest πŸƒ: Testing framework.
- Husky 🐢: Git hooks for automation.
- GitHub Actions 🐒🐒: For CI/CD infrastructure.
- GitHub Pages 🐌: For easy and **free** deployment.

## Deployment

The web application is deployed on GitHub Pages and can be accessed at the following URL:

πŸ‘‰ [GitHub Insights Dashboard](https://jagoda11.github.io/github-insights-dashboard/)

GitHub Pages offers a **free** way to deploy static applications. Integration with GitHub allows for automatic updates with every push, making it a convenient option for hosting static sites. For more information, visit the [GitHub Pages documentation](https://docs.github.com/en/pages).

## Authentication with GitHub Personal Access Token (PAT)

This application requires authentication using a GitHub Personal Access Token (PAT).

## Features

### 1. **Dashboard Overview**

Provides an intuitive interface for navigating between charts and lists, giving users a comprehensive view of their GitHub data.

![Dashboard Screenshot](./assets/dashboard.png)

### 2. **Commit Frequency**

Displays a bar chart visualizing commits by month to help users analyze contribution trends.

![Commit Frequency Chart](./assets/commit-chart.png)

### 3. **Commit List**

Lists all commits with details such as the author, message, and commit date, allowing users to filter and view specific activity.

![Commit List Screenshot](./assets/commit-list.png)

### 4. **Programming Languages**

Shows a pie chart of the programming languages used across repositories, highlighting your most frequently used languages.

![Programming Languages Chart](./assets/language-chart.png)

## πŸš€ Initial Setup

To get started, clone the repository and install dependencies:

```bash
git clone https://github.com/Jagoda11/github-insights-dashboard.git
cd github-insights-dashboard
npm install --legacy-peer-deps
```

Start the development server:

```bash
npm start
```

Your browser should navigate to:

```bash
http://localhost:3002/github-insights-dashboard
```

## ⚠️ Note on Commits

If you're having trouble making a commit, it might be due to the `precommit` hook, which runs the `lint` and `test` scripts before each commit. If these scripts find any errors, the commit will be blocked. Check the output for any lint or test errors and fix them before trying to commit again.

## πŸ“œ Scripts

To run these scripts, use `npm run `:

- `start`: πŸš€ Builds the TypeScript code and starts the application.
- `build`: πŸ”¨ Compiles the TypeScript code using the TypeScript compiler (`tsc`).
- `test`: πŸ§ͺ Runs tests using Jest and generates a coverage report.
- `format`: πŸ–‹οΈ Formats the code using Prettier.
- `lint`: 🧹 Lints all JavaScript and TypeScript files in the project using ESLint.
- `precommit`: πŸ”’ Runs the `lint` and `test` scripts before each commit to ensure code quality. This is managed by Husky 🐢.
- `pretest`: πŸ” Lints the code before running tests.
- `watch`: πŸ‘€ Runs tests in watch mode using Jest.
- `debug`: 🐞 Starts the application in debug mode using `nodemon`.
- `clean`: 🧽 Removes the `node_modules` directory and `package-lock.json` file.
- `prepare`: 🐾 Sets up Husky for managing git hooks.

## πŸ€– GitHub Actions Workflows

This repo includes several GitHub Actions workflows that automate various tasks:

- `ci.yml`: Runs your project's continuous integration (CI) tasks.
- `close-merged-pull-requests.yml`: Automatically closes pull requests that have been merged.
- `close-stale-issues-and-prs.yml`: Closes stale issues and pull requests.
- `label-new-pull-requests.yml`: Automatically adds labels to new pull requests.
- `thank-contributors-on-issue-close.yml`: Thanks contributors when an issue they commented on is closed.
- `welcome-new-pull-requests.yml`: Posts a welcome message on new pull requests.
- `welcome.yml`: Posts a welcome message on new issues.
- `npm-upgrade.yml`: checks for new versions of the dependencies and updates package.json and package-lock.json

These workflows use the `secrets.GITHUB_TOKEN` secret, which GitHub automatically creates for every repository. You can create a personal access token and add it as a secret in your repository. For more information, see [Creating and storing encrypted secrets](https://docs.github.com/en/actions/reference/encrypted-secrets).

## 🌐 GitHub Codespaces Support

This project includes a `.devcontainer.json` file which allows you to work on this project in a Docker container using [GitHub Codespaces](https://github.com/features/codespaces). This helps to maintain a consistent development environment, making it easier for you to collaborate with others without having to worry about individual setup.

GitHub Codespaces configures your development environment based on your project's needs using this file. When you create a new codespace for this project, the Codespaces environment is automatically configured as per the settings defined in `.devcontainer.json`.

To use GitHub Codespaces:

1. Navigate to the main page of the repository.
2. Click the Code button and then click "Open with Codespaces".
3. Click "+ New codespace".

Your development environment is now set up and running in a Docker container in the cloud. All commands you run in the Codespaces terminal will be executed inside the container. Any changes you make to the project will be reflected in the container and vice versa.

## 🀝 Contributing

Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md).
for details on our code of conduct and the process for submitting pull requests.

## πŸ“œ Code of Conduct

Please read our [Code of Conduct](CODE_OF_CONDUCT.md) to keep our community approachable and respectable.

## πŸ“ License

This project is licensed under the terms of the Proprietary License Agreement. For more details, see the [LICENSE](LICENSE.md) file.

## Use of GitHub Logo

The GitHub logo is used for authentication purposes in compliance with [GitHub’s branding guidelines](https://github.com/logos).

Β© 2024 Jagoda11