# Karwan Welfare Foundation — Laravel 12 Dynamic Website Starter

This package contains the **application-specific files** for a Laravel 12 website with:

- Dynamic Posts / News
- Dynamic Events
- Dynamic Programs
- Categories
- Donation request form + editable bank information
- Feedback page
- Beneficiary / needy-person self registration
- English / Pashto / Dari content fields
- Admin dashboard and CRUD pages
- Social links and organization settings

## 1. Create a fresh Laravel 12 project

```bash
composer create-project laravel/laravel:^12.0 karwan-foundation
cd karwan-foundation
```

## 2. Copy this starter over the Laravel project

Copy the contents of this package into the Laravel project root and allow it to merge/replace matching application files.

## 3. Authentication

This starter protects `/admin` with Laravel's `auth` middleware and an `is_admin` flag.
It includes a minimal admin login at `/login`, so Laravel Breeze is optional.

## 4. Configure database

Example `.env`:

```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=karwan_foundation
DB_USERNAME=root
DB_PASSWORD=
```

## 5. Configure first admin account

Add these values to `.env` before seeding:

```env
ADMIN_NAME="Karwan Administrator"
ADMIN_EMAIL="admin@karwan.test"
ADMIN_PASSWORD="use-a-strong-password"
```

## 6. Migrate and seed

```bash
php artisan migrate
php artisan db:seed
```

## 7. Storage link

```bash
php artisan storage:link
```

## 8. Run

```bash
php artisan serve
```

Public site: `http://127.0.0.1:8000`

Admin: `http://127.0.0.1:8000/admin`

## Important

- Change all bank details from **Admin → Settings**. No real bank number is hard-coded.
- The donation form records donation intentions/requests. Connect a payment gateway separately if you want online card payments.
- Public content supports three language values: `en`, `ps`, `fa`.
- The included logo is copied from the logo supplied for this project.
