/nba-playes

NBA Players is a React-based web application that leverages the BallDontLie API to display NBA player statistics and allows users to search for players, mark their favorites, and manage these preferences in a visually appealing interface.

Primary LanguageTypeScript

NBA Players

NBA Players is a React-based web application that leverages the BallDontLie API to display NBA player statistics and allows users to search for players, mark their favorites, and manage these preferences in a visually appealing interface. You can view the live site here: NBA Players Live Site.

Features

  • Player Search: Search for NBA players using the BallDontLie API.
  • Favorite Players: Users can mark players as favorites and manage this list.
  • Responsive Design: Optimized for both desktop and mobile view.
  • Infinite Scrolling: Load more players dynamically as you scroll.
  • Dark Mode Toggle: Users can switch between light and dark themes in the favorites section.

Installation

To get started with NBA Players, follow these steps:

  1. Clone the Repository

    git clone https://github.com/obrm/nba-playes.git
    cd NBA Players
  2. Install Dependencies

    npm install
  3. Environment Variables

    Create a .env file at the root of your project and add the following:

    VITE_NBA_API_KEY=your_api_key_here
    VITE_API_URL=https://api.balldontlie.io/v1
    

    Replace your_api_key_here with your actual BallDontLie API key.

  4. Run the Application

    npm run dev

Usage

Navigate through the application to search for NBA players, add or remove them from your favorites, and toggle between the light and dark themes in the favorites section. Use the responsive layout to access the app on any device.

Screenshots

Main Layout Desktop

Main Layout Desktop

Main Dark Theme Layout Desktop

Main Dark Theme Layout Desktop

Main Layout With Search Desktop

Main Layout With Search Desktop

Main Layout Mobile

Main Layout Mobile

Favorites Page Mobile

Favorites Page Mobile

Main Layout With Search Mobile

Main Layout With Search Mobile

Technologies

  • Vite: Provides an extremely fast development environment with out-of-the-box features like Hot Module Replacement (HMR).
  • TypeScript: Ensures type safety, enhancing the development process by catching errors at compile time.
  • React: Facilitates the creation of interactive UIs.
  • Tailwind CSS & DaisyUI: Used for rapid UI development with a focus on design customization.
  • Axios: Handles API requests.
  • Lodash: Offers utility functions for common programming tasks.
  • React Icons, React Infinite Scroll Component, React Switch, React Toastify: Provide additional UI/UX enhancements.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your updates.

License

NBA Players is released under the MIT License.