DONASIAKU 🤝

Bridging Kindness, Connecting Needs.
A modern web platform connecting donors with beneficiaries to facilitate transparent and efficient goods donation.

View Demo · Report Bug · Request Feature

📖 Table of Contents

1. About The Project
2. Tech Stack
3. Key Features
4. Getting Started
5. API Reference
6. Roadmap
7. License

💡 About The Project

Donasiaku is designed to solve the problem of unused goods piling up while many people are in need. We provide a seamless platform where:

• Donors can easily list items they wish to give away.
• Beneficiaries can browse available items and request them directly.
• Both parties can communicate securely via an integrated chat system to arrange delivery.

Built with a Monorepo architecture, combining the robustness of Laravel (API) and the interactivity of React (UI).

🛠 Tech Stack

Backend (Server)

• Framework: Laravel 11
• Language: PHP 8.2+
• Auth: Laravel Sanctum (Token based)
• Database: MySQL

Frontend (Client)

• Framework: React.js (Vite)
• Styling: Tailwind CSS + PostCSS
• State Management: React Hooks
• HTTP Client: Axios
• Routing: React Router DOM

🚀 Key Features

🐯 For Donors

• Manage Donations: Create, update, and delete donation listings easily.
• Request Approval: Review incoming requests from beneficiaries.
• Live Chat: Chat directly with potential recipients to discuss logistics.

🙋‍♂️ For Beneficiaries (Penerima)

• Browse Catalog: Filter available donations by category or recency.
• Request Items: One-click request mechanism.
• Request History: Track the status of your applications (Pending/Approved/Rejected).

🔐 Security & Core

• Secure Authentication: Registration and Login flows for different roles.
• Real-time Validation: Form inputs are validated on both client and server.
• Responsive Design: Optimized for Desktop, Tablet, and Mobile.

⚡ Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v18+)
• Composer
• PHP (v8.2+)
• MySQL Server

1. Clone the Repository

git clone [https://github.com/your-username/donasiaku.git](https://github.com/your-username/donasiaku.git)
cd donasiaku

2. Backend Setup (Laravel)

cd backend

# Install PHP dependencies
composer install

# Setup Environment
cp .env.example .env
# NOTE: Open .env and configure your DB_DATABASE, DB_USERNAME, DB_PASSWORD

# Generate Key & Migrate
php artisan key:generate
php artisan migrate

# Start Server
php artisan serve

3. Frontend Setup (React)

Open a new terminal terminal window:

cd frontend

# Install JS dependencies
npm install

# Start Client
npm run dev

The App should now be running at http://localhost:5173 and the API at http://localhost:8000.

🔌 API Reference

Here are the main endpoints available in the backend:

Method	Endpoint	Description	Auth Required
POST	/api/register	Register new user	❌
POST	/api/login	Login user & get token	❌
GET	/api/donations	Get all available donations	✅
POST	/api/donations	Create a new donation	✅
GET	/api/donations/{id}	Get donation details	✅
POST	/api/chat/send	Send a message	✅
GET	/api/user	Get current user profile	✅

🗺 Roadmap

We have exciting plans for the future of Donasiaku:

• Notification System: Email and Push notifications for new requests.
• Map Integration: View donation locations on Google Maps.
• Rating System: Allow users to rate their experience.
• Delivery Integration: Partner with logistics APIs (e.g., GoSend/GrabExpress).
• Dark Mode: Enhanced UI theming.

📂 Project Structure

donasiaku/
├── backend/            # Laravel API
│   ├── app/
│   ├── database/
│   └── routes/api.php  # API Routes defined here
├── frontend/           # React Application
│   ├── src/
│   │   ├── features/   # Feature-based folder structure (Auth, Donatur, Penerima)
│   │   ├── components/ # Shared UI components (Button, Card, Inputs)
│   │   └── services/   # API Service logic (Axios setup)
└── README.md

📄 License

Distributed under the MIT License. See LICENSE for more information.