Welcome to the Movie Search App! π₯πΏ This is a simple, beginner-friendly React app that lets you search for your favorite movies using the OMDB API. It's a fun project to help you learn React, API integration, and some Tailwind CSS for styling.
Before you start, make sure you have the following installed on your system:
git clone https://github.com/your-username/movie-search-app.git
cd movie-search-app
Run the following command to install the necessary dependencies:
npm install
# or
yarn install
.env
file in the root directory of your project and add your API key:REACT_APP_OMDB_API_KEY=your_api_key_here
Once everything is set up, start the development server:
npm start
# or
yarn start
Visit http://localhost:3000
in your browser, and you should see the Movie Search App in action!
Hereβs a quick breakdown of the files in this project:
movie-search-app/
β
βββ public/ # Static assets
βββ src/
β βββ components/
β β βββ SearchBar.js # Component for the movie search input
β β βββ MovieList.js # Component to display a list of movies
β β βββ MovieCard.js # Component to show details for a single movie
β βββ App.js # Main application component
β βββ index.js # Entry point of the React app
β βββ index.css # Tailwind CSS imports and custom styles
β
βββ .env # Environment variables (like API key)
βββ .gitignore # Files and directories to be ignored by Git
βββ README.md # You are here! π
βββ package.json # Project dependencies and scripts
SearchBar.js
: Handles user input for searching movies.MovieList.js
: Displays the results from the OMDB API.MovieCard.js
: A card layout to show individual movie details (poster, title, and year).We love contributions! Whether youβre fixing a bug, adding a feature, or improving documentation, weβd love your help. Hereβs how you can contribute:
git clone https://github.com/your-username/movie-search-app.git
cd movie-search-app
git checkout -b feature/your-feature-name
git add .
git commit -m "Add a new feature or fix a bug"
git push origin feature/your-feature-name
Here are some features we're planning to add:
Feel free to contribute any of these features or suggest your own!
If you're new to React, Tailwind CSS, or APIs, here are some resources to help you:
A big thank you to OMDB API for providing the movie data and to the amazing open-source community for making this project possible!
This project is licensed under the MIT License - see the LICENSE file for details.