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

https://github.com/techjmi/exelon

website url
https://github.com/techjmi/exelon

Last synced: 11 months ago
JSON representation

website url

Awesome Lists containing this project

README

          

# GitHub User Finder

GitHub User Finder is a React application that allows users to search for GitHub profiles and view their details along with the top 5 repositories.

## ๐Ÿ› ๏ธ Tech Stack
- React (Vite)
- Axios
- Tailwind CSS
- GitHub API
- Skeleton UI with Lazy Loading

## ๐Ÿ—‚๏ธ Folder Structure
```
.
โ”œโ”€โ”€ public
โ”œโ”€โ”€ src
โ”œโ”€โ”€ api
โ”‚ โ””โ”€โ”€ api.js
โ”œโ”€โ”€ components
โ”‚ โ”œโ”€โ”€ SearchBar.js
โ”‚ โ”œโ”€โ”€ Profile.js
โ”‚ โ”œโ”€โ”€ Repo.js
โ”‚ โ”œโ”€โ”€ Error.js
โ”‚ โ””โ”€โ”€ Loading.js
โ”œโ”€โ”€ App.js
โ”œโ”€โ”€ main.jsx
โ””โ”€โ”€ index.css
โ”œโ”€โ”€ .env
โ””โ”€โ”€ package.json
```

## โš™๏ธ Environment Variables
Create a `.env` file in the root directory:
```
VITE_GITHUB_TOKEN=your_github_token
```

## ๐Ÿš€ Installation and Running the App
```bash
# Clone the repository
git clone https://github.com/techjmi/exelon

# Navigate to the project directory
cd exelon, client

# Install dependencies
npm install

# Start the development server
npm run dev
```

## ๐Ÿงช Features
- Search GitHub profiles by username
- Display profile details (avatar, followers, following)
- List top 5 repositories (sorted by stars)
- Skeleton loading for better UX
- Error handling for invalid users or API errors