Authentication System

A full-stack authentication system built with Laravel (Backend) and React + TypeScript (Frontend).

Project Structure

auth-system/
├── backend/          # Laravel API Backend
│   ├── app/         # Application logic
│   ├── database/    # Migrations, seeders, factories
│   ├── routes/      # API routes
│   ├── tests/       # Backend tests
│   └── ...
├── frontend/         # React + TypeScript Frontend
│   ├── src/         # Source code
│   ├── public/      # Static assets
│   ├── tests/       # Frontend tests
│   └── ...
└── README.md         # This file

Prerequisites

Backend Requirements

PHP: ^8.2
Composer: Latest version
Node.js: ^18.0 (for asset compilation)
NPM/Yarn: For frontend dependencies
Database: SQLite (included) or MySQL/PostgreSQL

Frontend Requirements

Node.js: ^18.0
NPM/Yarn: Package manager

Quick Start

For a fast setup, run these commands in sequence:

# 1. Setup Backend
cd backend
composer install
cp .env.example .env
php artisan key:generate
touch database/database.sqlite
php artisan migrate
npm install && npm run build

# 2. Setup Frontend (in a new terminal)
cd ../frontend
npm install

# 3. Start Backend Server
cd ../backend
php artisan serve

# 4. Start Frontend Server (in another terminal)
cd frontend
npm run dev

Your application will be available at:

Frontend: http://localhost:5173
Backend API: http://localhost:8000

Installation & Setup

Backend Setup (Laravel API)

Navigate to the backend directory:
```
cd backend
```
Install PHP dependencies:
```
composer install
```

Environment Configuration:

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

Database Setup:

# Create SQLite database (if not exists)
touch database/database.sqlite

# Run migrations
php artisan migrate

Install Node.js dependencies for asset compilation:
```
npm install
```
Build frontend assets:
```
npm run build
```

Frontend Setup (React + TypeScript)

Navigate to the frontend directory:
```
cd frontend
```
Install dependencies:
```
npm install
```

Running the Project

Backend Development Server

Option 1: Simple Laravel Server

cd backend
php artisan serve

The API will be available at: http://localhost:8000

Option 2: Full Development Environment (Recommended)

cd backend
composer run dev

This command runs:

Laravel server (http://localhost:8000)
Queue worker
Log monitoring
Asset compilation with hot reload

Frontend Development Server

cd frontend
npm run dev

The frontend will be available at: http://localhost:5173

Running Both Together

Terminal 1 (Backend):

cd backend
php artisan serve

Terminal 2 (Frontend):

cd frontend
npm run dev

API Endpoints

The backend provides the following authentication endpoints:

POST /api/register - User registration
POST /api/login - User login
POST /api/logout - User logout
GET /api/user - Get authenticated user
PUT /api/profile - Update user profile
POST /api/password/change - Change password
POST /api/password/email - Request password reset
POST /api/password/reset - Reset password
POST /api/email/verify - Verify email address

Testing

Backend Tests

cd backend

# Run all tests
php artisan test

# Run specific test suites
php artisan test --testsuite=Feature  # Feature tests
php artisan test --testsuite=Unit     # Unit tests

# Run with coverage
php artisan test --coverage

Frontend Tests

cd frontend

# Run tests
npm run test

# Run tests with UI
npm run test:ui

# Run tests with coverage
npm run test:coverage

Environment Configuration

Backend (.env)

Key environment variables for the backend:

APP_NAME="Authentication System"
APP_ENV=local
APP_KEY=base64:your-generated-key
APP_DEBUG=true
APP_URL=http://localhost:8000

DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database.sqlite

MAIL_MAILER=log

Frontend (Environment Variables)

Create a .env file in the frontend directory:

VITE_API_URL=http://localhost:8000
VITE_APP_NAME="Authentication System"

Features