|
1 | | -This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app). |
| 1 | +<h1 align="center">GitGlance</h1> |
| 2 | +<h3 align="center">Tool for visualizing GitHub profiles</h3> |
| 3 | +<p align="center"> |
| 4 | + <a href="https://gitglance.vercel.app/">View Demo</a> |
| 5 | + · |
| 6 | + <a href="https://github.com/devXprite/gitglance/issues/new?assignees=&labels=bug&template=bug_report.md&title=">Report Bug</a> |
| 7 | + · |
| 8 | + <a href="https://github.com/devXprite/gitglance/issues">Request Feature</a> |
| 9 | +</p> |
| 10 | +<br/> |
2 | 11 |
|
3 | | -## Getting Started |
| 12 | +<p>GitGlance is a powerful tool for visualizing a developer's GitHub profile, showcasing their contributions, fields of expertise, and much more. With GitGlance, developers can gain insights into their GitHub activity in an intuitive and visually appealing manner. |
| 13 | +</p> |
4 | 14 |
|
5 | | -First, run the development server: |
| 15 | +## Features |
| 16 | +- **GitHub Profile Visualization:** GitGlance provides a comprehensive visualization of a developer's GitHub profile, including their contributions, repositories, and more. |
| 17 | +- **Field of Contributions:** Understand the areas in which the developer contributes the most through a graphical representation. |
| 18 | +- **GitHub GraphQL API Integration:** Utilizing the GitHub GraphQL API, GitGlance fetches user data directly from GitHub, ensuring accurate and up-to-date information. |
| 19 | +- **Next.js & Tailwind CSS:** Built with Next.js for efficient server-side rendering and Tailwind CSS for easy styling and customization. |
| 20 | +- **Responsive Design:** GitGlance is designed to be responsive, ensuring a seamless experience across various devices and screen sizes. |
6 | 21 |
|
7 | | -```bash |
8 | | -npm run dev |
9 | | -# or |
10 | | -yarn dev |
11 | | -# or |
12 | | -pnpm dev |
13 | | -# or |
14 | | -bun dev |
15 | | -``` |
| 22 | +## Installation |
| 23 | +To run GitGlance locally, follow these steps: |
16 | 24 |
|
17 | | -Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. |
| 25 | +1. Clone the repository: |
| 26 | + ```bash |
| 27 | + git clone https://github.com/your-username/gitglance.git |
| 28 | + ``` |
18 | 29 |
|
19 | | -You can start editing the page by modifying `app/page.js`. The page auto-updates as you edit the file. |
| 30 | +2. Navigate to the project directory: |
| 31 | + ```bash |
| 32 | + cd gitglance |
| 33 | + ``` |
| 34 | +3. Create a .env file in the root directory of the project by copying the .env.example file: |
| 35 | + ```bash |
| 36 | + cp .env.example .env |
| 37 | + ``` |
| 38 | +4. Open the .env file and add your GitHub Personal Access Token: |
| 39 | + ```bash |
| 40 | + GITHUB_TOKEN= |
| 41 | + ``` |
| 42 | +5. Install dependencies: |
| 43 | + ```bash |
| 44 | + npm install |
| 45 | + ``` |
| 46 | +6. Start the development server: |
| 47 | + ```bash |
| 48 | + npm run dev |
| 49 | + ``` |
| 50 | +7. Open your browser and visit `http://localhost:3000` |
| 51 | + |
| 52 | + |
| 53 | + |
| 54 | +## Contributing |
| 55 | +Contributions are welcome! If you encounter any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request. |
20 | 56 |
|
21 | | -This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font. |
| 57 | +## License |
| 58 | +This project is licensed under the MIT License. see the LICENSE file for details. |
22 | 59 |
|
23 | | -## Learn More |
| 60 | +## Acknowledgements |
24 | 61 |
|
25 | | -To learn more about Next.js, take a look at the following resources: |
| 62 | +GitGlance utilizes the following technologies and libraries: |
26 | 63 |
|
27 | | -- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API. |
28 | | -- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial. |
29 | | - |
30 | | -You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome! |
31 | | - |
32 | | -## Deploy on Vercel |
33 | | - |
34 | | -The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js. |
35 | | - |
36 | | -Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details. |
| 64 | +- [Next.js](https://nextjs.org/) |
| 65 | +- [Tailwind CSS](https://tailwindcss.com/) |
| 66 | +- [GitHub GraphQL API](https://docs.github.com/en/graphql) |
| 67 | +- [Node.js](https://nodejs.org/) |
0 commit comments