Skip to content

shoyodeyy/E-Learning

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

187 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌟 Laravel 11 + React + Tailwind CSS 🌟

Laravel React Tailwind CSS PHP MySQL

πŸš€ A Modern Full-Stack Web Application πŸš€

Built with cutting-edge technologies for maximum performance and developer experience


Typing SVG

✨ Features

🎯 Backend Features

  • πŸ” Laravel Sanctum Authentication
  • πŸ“Š RESTful API Architecture
  • πŸ—„οΈ MySQL Database Integration
  • πŸ›‘οΈ Security Best Practices
  • πŸ“ Comprehensive Documentation

🎨 Frontend Features

  • ⚑ React 18 with Hooks
  • 🎨 Tailwind CSS Styling
  • πŸ“± Responsive Design
  • πŸ”„ Axios HTTP Client
  • ⚑ Vite Build Tool

πŸ› οΈ Tech Stack

Category Technology Version Description
πŸ”§ Backend Laravel 11.x PHP Framework
βš›οΈ Frontend React 18.x JavaScript Library
🎨 Styling Tailwind CSS 3.x Utility-first CSS
πŸ—„οΈ Database MySQL 8.0+ Relational Database
πŸ“‘ HTTP Client Axios - Promise-based HTTP
⚑ Build Tool Vite - Frontend Tooling

πŸ“ Project Architecture

πŸ—οΈ project-root/
β”œβ”€β”€ πŸ”§ backend/                 # Laravel 11 API Server
β”‚   β”œβ”€β”€ πŸ“± app/                 # Application Logic
β”‚   β”‚   β”œβ”€β”€ Http/Controllers/   # API Controllers
β”‚   β”‚   β”œβ”€β”€ Models/            # Eloquent Models
β”‚   β”‚   └── Middleware/        # Custom Middleware
β”‚   β”œβ”€β”€ βš™οΈ config/             # Configuration Files
β”‚   β”œβ”€β”€ πŸ—„οΈ database/           # Migrations & Seeders
β”‚   β”‚   β”œβ”€β”€ migrations/        # Database Migrations
β”‚   β”‚   └── seeders/          # Database Seeders
β”‚   β”œβ”€β”€ πŸ›£οΈ routes/             # API Routes
β”‚   └── πŸ“„ .env.example        # Environment Template
β”‚
└── βš›οΈ frontend/               # React Application
β”œβ”€β”€ πŸ“± src/                # Source Code
β”‚   β”œβ”€β”€ components/        # React Components
β”‚   β”œβ”€β”€ pages/            # Page Components
β”‚   β”œβ”€β”€ services/         # API Services
β”‚   └── utils/            # Utility Functions
β”œβ”€β”€ 🌐 public/            # Static Assets
β”œβ”€β”€ πŸ“¦ package.json       # Dependencies
└── βš™οΈ tailwind.config.js  # Tailwind Configuration

πŸ”§ System Requirements

πŸ”§ Backend Requirements

Component Version Status
PHP >= 8.2 Required
Composer Latest Required
MySQL >= 8.0 Required

βš›οΈ Frontend Requirements

Component Version Status
Node.js >= 18.0 Required
NPM >= 8.0 Required
Yarn >= 1.22 Optional

πŸš€ Quick Start Guide

πŸ“₯ 1. Clone Repository

# πŸ“‚ Clone the project
git clone <repository-url>
cd project-root

πŸ”§ 2. Backend Setup

# πŸ“ Navigate to backend
cd my-project-backend

# πŸ“¦ Install dependencies
composer install

# πŸ“„ Setup environment
cp .env.example .env

# πŸ”‘ Generate application key
php artisan key:generate

# πŸ—„οΈ Run migrations
php artisan migrate

# 🌱 Seed database (optional)
php artisan db:seed

βš›οΈ 3. Frontend Setup

# πŸ“ Navigate to frontend
cd ../my-project-frontend

# πŸ“¦ Install dependencies
npm install
# or
yarn install

# πŸ“„ Create environment file
touch .env

βš™οΈ Configuration

πŸ”§ Backend Configuration

πŸ“„ Update backend/.env

# πŸ—„οΈ Database Configuration
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_react_db
DB_USERNAME=your_username
DB_PASSWORD=your_password

# πŸ” Laravel Sanctum
SANCTUM_STATEFUL_DOMAINS=localhost:5173

# 🌐 CORS Configuration
FRONTEND_URL=http://localhost:5173
βš›οΈ Frontend Configuration

πŸ“„ Create frontend/.env

# 🌐 API Configuration
VITE_API_URL=http://localhost:8000/api
VITE_APP_URL=http://localhost:5173

# πŸ” Authentication
VITE_SANCTUM_STATEFUL_DOMAINS=localhost:8000

πŸ–₯️ Development Servers

πŸš€ Start Both Servers Simultaneously

πŸ”§ Terminal 1 - Laravel API

cd backend

# πŸš€ Start Laravel server
php artisan serve

🌐 API Server
http://localhost:8000

Laravel

βš›οΈ Terminal 2 - React App

cd frontend

# πŸš€ Start React server
npm run dev

🌐 Frontend App
http://localhost:5173

React

🀝 Contributing

We welcome contributions! πŸŽ‰

Contributors

  1. 🍴 Fork the repository
  2. 🌿 Create your feature branch (git checkout -b feature/AmazingFeature)
  3. πŸ’Ύ Commit your changes (git commit -m 'Add some AmazingFeature')
  4. πŸ“€ Push to the branch (git push origin feature/AmazingFeature)
  5. πŸ”„ Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License.

License: MIT

πŸ“ž Support

Need help? We're here for you! πŸ’ͺ

GitHub Issues GitHub Discussions


🌟 Star this repository if you found it helpful! 🌟

GitHub stars GitHub forks

Made with ❀️ by Shoyo

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors