/buckit

Bucket List Generator

Primary LanguageTypeScript

🚀 Buck'it App

The Buck'it App is an awesome bucket list application built with React that helps you keep track of your wildest dreams and adventures! 🌟✨

✨ Features

  • Random Inspiration: Get inspired with a random bucket list item fetched from an API. Each item is designed to ignite your sense of adventure and make you dream big! 🌍🌌

  • Personal Bucket List: Create your own bucket list by adding the displayed items that resonate with you. Keep track of all the incredible experiences you want to achieve in your lifetime! 📜✍️

  • Easy Item Removal: Changed your mind about a particular goal? No worries! You can effortlessly remove items from your bucket list with just a click. It's all about embracing the freedom to evolve and adjust your dreams! ♻️❌

🛠️ Technologies Used

  • React: A powerful and popular JavaScript library for building user interfaces. 💻🌈

  • React Hooks: Use state and effect hooks to manage component state and lifecycle events. It's the modern and efficient way to handle complex logic in your components! ⚛️⚙️

  • TailwindCSS: Custom styling using Tailwind CSS to create a visually appealing and responsive user interface. 💅🎨

  • React Icons: A collection of customizable icons for React applications, making it easy to add visual elements to your project. 🚀🎉

  • API-Ninjas API: Fetches a diverse range of exciting bucket list items from an external API. Expand your horizons and explore new possibilities! 🌟🔍

🚀 Getting Started

Follow these simple steps to get started with the Buck'it App:

  1. Clone the Repository: Begin by cloning this repository to your local machine using the following command:

    git clone https://github.com/attilalb/buckit.git
    
  2. Navigate to the Project Directory: Move into the project directory using the following command:

    cd buckit-app
    
  3. Install Dependencies: Install the necessary dependencies by running the following command:

    npm install
    
  4. Start the Development Server: Launch the development server with the following command:

    npm start 
    
  5. Open the App: Open your favorite web browser and visit http://localhost:3000 to see the Buck'it App in action!

🎉 Contribution

Contributions are more than welcome! If you have any ideas, suggestions, or improvements, please feel free to open an issue or submit a pull request. Together, let's make the Buck'it App even more incredible! 🙌💪

📄 License

This project is licensed under the MIT License. See the LICENSE file for more information.


Built with ❤️ by @attilalb