Skip to content

andrewmartinn/devfinder-react

Repository files navigation

Devfinder React

DevFinder is a React application that allows users to search for GitHub profiles, view user details, and explore user repositories. The app leverages the GitHub API for fetching and displaying user data.

View Live Demo

Homepage devfinder-preview

Profile Details Page devfinder-profile

Technologies Used

  • Vite: Fast, opinionated web dev build tool
  • TypeScript: Typed superset of JavaScript
  • Chakra UI: Simple, modular, and accessible component library
  • React Router: Declarative routing for React applications
  • React Icons:A library containing popular icons for React projects, used for displaying various icons throughout the application.
  • Framer Motion: Animation library for React
  • Github API: Official GitHub API for fetching user and repository data

Project Features

  • User Search: Search for GitHub users by their username.
  • User Profile Details: View detailed information about GitHub users, including their repositories, followers, and following.
  • Repository List: Display list of repositories for each user, with details like stars, forks, and language used.
  • Responsive Design: Ensure the application is optimized for various screen sizes and devices.
  • Animations: Implemented different animations effects and transtitions for better user experience.
  • Toast Service: Built reusable toast service to display warnings or errors throughout the app.
  • Theme Toggle: Users can toggle between dark and light theme according to user preference, the app is designed to adapt to colors and backgrounds based on selected theme.

Project Outcomes

  • Context API and Reducers: Managed global application state efficiently using the Context API along with reducers functions. This included handling user data, toasts, search results, loading states, and error states. The use of reducers helped in managing complex state logic and state transitions effecient.

  • TypeScript Integration: Utilized TypeScript for type safety and better development experience.

  • Third-Party API Integration: Successfully interacted with the GitHub API to fetch and display user profiles and repositories dynamically based on user queries.

  • Context API: Utilized the Context API to manage global application state efficiently. This included managing gifs, user favorites, filters, and other application-wide data.

Project Setup

This project was bootstrapped with Vite

To get started you need to:

  • Clone the project
  • Install listed dependencies
  • Run available scripts
  • Create a env file

Install dependencies

yarn install

Create an enviroment file to store Github API Authentication Token

VITE_APP_GITHUB_API_TOKEN=your-api-key-here

Run React dev server

yarn dev

To build for production

yarn build

Deployment

To deploy this project run

yarn run deploy

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published