Star Wars Wiki is a web application that provides detailed information about the starships in the Star Wars universe. Built with React, Tailwind CSS, Firebase, and Redux, this app allows users to search and explore data on various starships, with up-to-date information presented in a visually appealing manner.
- React: JavaScript library for building user interfaces.
- Tailwind CSS: CSS framework for modern and responsive design.
- Firebase: Application development platform for real-time database and authentication.
- Redux: Library for global state management in the application.
- Starship list: General view of each starship in Starwars Universe.
- Details for each starship: Detailed view of each starship with comprehensive information.
- Details for each starship's pilot: Clicked Ship Pilots Overview
- Films: List of films where each starship appear.
- Authentication: User registration and login via Firebase Authentication.
Follow these steps to clone and run the project locally.
-
Clone the repository:
git clone https://github.com/tomi-casabona/Starwars-React-JS
-
Navigate to the project directory:
cd Starwars-React-JS
-
Install dependencies:
npm install
-
Create a
.env.local
file in the project root with your Firebase credentials:VITE_FIREBASE_API_KEY=your_api_key VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain VITE_FIREBASE_PROJECT_ID=your_project_id VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket VITE_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id VITE_FIREBASE_APP_ID=your_app_id VITE_FIREBASE_MEASUREMENT_ID=your_firebase_measurement_id
-
Start the application:
npm run dev
The application should be available at http://localhost:5173.
This README will guide you through the steps required to create a project in Firebase and configure the necessary environment variables to integrate it with an application using Vite.
- Go to Firebase Console.
- Click on "Add project".
- Enter a name for your project and follow the on-screen instructions to create it.
- In the Firebase console, select the project you just created.
- Go to the "Settings" section (gear icon) in the top left corner.
- Click on "Project settings".
- Scroll down to the "Your apps" section.
- Select the web app for which you want to obtain the credentials, or click on "Add app" if you haven't created one yet.
- Copy the provided credentials, including:
- API Key
- Auth Domain
- Project ID
- Storage Bucket
- Messaging Sender ID
- App ID
- Measurement ID
- Open your project in the code editor.
- Create a
.env.local
file in the root of the project if it doesn't already exist. - Add the following environment variables to the
.env.local
file with the credentials you copied in the previous step:
- Sign In: Sign in to have acces to the app.
- View Starship List: Scroll through the starship list.
- View Details: Click on your favourite starship card to view details.
- View Pilots and Movies: Scroll down to see the pilots and the movies it appears.
Thank you for using Star Wars Starships Catalog! May the Force be with you!