Skip to content

Fund Star is a web application designed to simplify the process of creating, managing, and supporting campaigns. Whether it's a personal need, a startup idea, or a charitable cause, Fund Star empowers users to make a difference. The platform allows campaign organizers to manage their projects while providing a seamless experience for donors.

Notifications You must be signed in to change notification settings

MRiDuL-ICE/Fund-Star-Client

Repository files navigation

🌟 Fund Star

Project Purpose
Fund Star is a web application designed to simplify the process of creating, managing, and supporting campaigns. Whether it's a personal need, a startup idea, or a charitable cause, Fund Star empowers users to make a difference. The platform allows campaign organizers to manage their projects while providing a seamless experience for donors.

🌐 Live URL

Fund Star Fund Star Server

πŸ›  Technologies Used

  • React.js
  • React Router
  • Tailwind CSS
  • Firebase Authentication
  • React Icons
  • SweetAlert2

πŸš€ Key Features

  1. Secure User Authentication

    • Login and registration with Firebase
    • Protected routes for secure user data access
  2. Campaign Management

    • Users can create, update, and delete campaigns
    • All campaigns displayed in a responsive card layout
  3. My Donations Section

    • View all the campaigns a user has contributed to
  4. Dynamic Dashboard

    • Real-time data updates for campaigns and donations
  5. User-Friendly Interface

    • Clean, responsive design with animations for a polished experience

πŸ“¦ NPM Packages Used

Core Dependencies

  • react: Frontend library
  • react-router-dom: For routing and navigation
  • firebase: Authentication and backend services
  • sweetalert2: Elegant alert popups

Styling

  • tailwindcss: Utility-first CSS framework
  • react-icons: Library for scalable icons

Development Tools

  • vite: Fast frontend build tool

πŸš€ Getting Started

Prerequisites

  • Node.js (v16 or later)
  • Firebase Account

Installation

  1. Install dependencies:
npm install
  1. Set up Firebase configuration:
    • Create a Firebase project
    • Copy your Firebase configuration details
    • Create a .env file with the following variables:
VITE_apiKey=
VITE_authDomain=
VITE_projectId=
VITE_storageBucket=
VITE_messagingSenderId=
VITE_appId=
  1. Start the development server:
npm run dev

πŸ“‚ Project Structure

src/
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ Header.jsx
β”‚   └── MainLayout.jsx
β”œβ”€β”€ firebase/
β”‚   └── firebase.js
β”œβ”€β”€ layouts/
β”‚   └── MainLayout.jsx
β”œβ”€β”€ pages/
β”‚   β”œβ”€β”€ About.jsx
β”‚   β”œβ”€β”€ AddNewCampaign.jsx
β”‚   β”œβ”€β”€ AllCampaigns.jsx
β”‚   β”œβ”€β”€ DetailsPage.jsx
β”‚   β”œβ”€β”€ ErrorPage.jsx
β”‚   β”œβ”€β”€ Home.jsx
β”‚   β”œβ”€β”€ Login.jsx
β”‚   β”œβ”€β”€ MyCampaigns.jsx
β”‚   β”œβ”€β”€ MyDonations.jsx
β”‚   β”œβ”€β”€ Register.jsx
β”‚   β”œβ”€β”€ RunningCampaigns.jsx
β”‚   β”œβ”€β”€ UpdateCampaign.jsx
β”‚   └── WhyUs.jsx
β”œβ”€β”€ provider/
β”‚   └── AuthProvider.jsx
β”œβ”€β”€ routes/
β”‚   β”œβ”€β”€ PrivateRoute.jsx
β”‚   └── routes.jsx
β”œβ”€β”€ App.css
β”œβ”€β”€ App.jsx
β”œβ”€β”€ index.css
└── main.jsx

πŸ” Authentication

  • Firebase Authentication is used for:
    • Email/Password login and signup
    • User profile management
    • Access control for protected routes

🎨 Design Philosophy

  • Mobile-first, responsive design
  • Accessible for all users
  • Interactive and intuitive user experience

πŸ“§ Contact

Md. Abdul Wahab - abdulwahab22400@gmail.com

πŸ™ Acknowledgements

  • React.js
  • Tailwind CSS
  • Firebase
  • React Icons
  • SweetAlert2

About

Fund Star is a web application designed to simplify the process of creating, managing, and supporting campaigns. Whether it's a personal need, a startup idea, or a charitable cause, Fund Star empowers users to make a difference. The platform allows campaign organizers to manage their projects while providing a seamless experience for donors.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages