# Amera API

Amera API is the backend service for the Amera application.  
It is built with Laravel and provides RESTful endpoints for mobile and web integrations.

---

## 🚀 Tech Stack

- Laravel
- PHP
- MySQL
- Composer

---

## 📦 Installation

Clone the repository:

```bash
git clone https://github.com/vndx/Amera-API
cd Amera-API
```

Install PHP dependencies:

```bash
composer install
```

Copy the environment file:

```bash
cp .env.example .env
```

Generate application key:

```bash
php artisan key:generate
```

---

## ⚙️ Configuration

Update your `.env` file with the correct database credentials and other environment settings:

```
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password
```

Run database migrations:

```bash
php artisan migrate
```

(Optional) Seed the database:

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

---

## 🛠 Run the Project

Start the development server:

```bash
php artisan serve
```

The API will be available at:

```
http://127.0.0.1:8000
```

---

## 🔗 Repository

GitHub Repository:

```bash
git clone https://github.com/vndx/Amera-API.git
```

(Replace `USERNAME` with your GitHub username or organization.)


## 🌿 Git Branch Structure

- **main** → Production (Live branch)
- **development** → Development branch

---

## 🔐 Authentication

This API uses Laravel authentication mechanisms.  
Ensure proper configuration depending on the authentication driver being used (Sanctum, Passport, JWT, etc.).

---

## 📄 Notes

- Make sure your database service is running before starting the server.
- Always run migrations after pulling new changes.
- Clear cache if needed:

```bash
php artisan config:clear
php artisan cache:clear
php artisan route:clear
```

---

## 👨‍💻 Project

Amera API Backend