Skip to content

Commit 47049f6

Browse files
committed
Add ReadMe
1 parent eb3516d commit 47049f6

File tree

3 files changed

+79
-27
lines changed

3 files changed

+79
-27
lines changed

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2024 Prateek
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 58 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,67 @@
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/>
211

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>
414

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.
621

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:
1624

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+
```
1829

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.
2056

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.
2259

23-
## Learn More
60+
## Acknowledgements
2461

25-
To learn more about Next.js, take a look at the following resources:
62+
GitGlance utilizes the following technologies and libraries:
2663

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/)

public/logo.jpeg

10.6 KB
Loading

0 commit comments

Comments
 (0)