Your IP : 216.73.216.79
# Your Project Name
A Laravel-based CMS with frontend site builder, components system, and dynamic permissions.
## Requirements
- PHP 8.3+
- Composer 2.x
- Node.js 18+
- PostgreSQL 14+ (or MySQL/MariaDB)
- Git
## Installation
### 1. Clone & Setup Environment
```bash
# Clone the repository
git clone <repository-url> your-project-name
cd your-project-name
# Copy environment file
cp .env.example .env
```
### 2. Configure Database
Edit `.env` file with your database credentials:
```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
```
For PostgreSQL:
```env
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
```
### 3. Install PHP Dependencies
```bash
composer install
```
### 4. Generate Application Key
```bash
php artisan key:generate
```
### 5. Run Migrations
```bash
php artisan migrate
```
### 6. Seed Database (Optional - creates default admin user)
```bash
php artisan db:seed
```
Default superadmin credentials:
- Email: superadmin@example.com
- Password: password
### 7. Install Frontend Dependencies
```bash
# Install root dependencies
npm install
# Install TailAdmin template dependencies
cd public/tailadmin
npm install
cd ../../
```
### 8. Build Assets
```bash
# Build for production
npm run build
# Or for development with hot reload
npm run dev
```
### 9. Create Storage Link
```bash
php artisan storage:link
```
### 10. Start Development Server
```bash
php artisan serve
```
Visit `http://localhost:8000` in your browser.
## Quick Start Checklist
- [ ] Clone repository
- [ ] Copy `.env.example` to `.env`
- [ ] Configure database credentials
- [ ] Run `composer install`
- [ ] Run `php artisan key:generate`
- [ ] Run `php artisan migrate`
- [ ] Run `php artisan db:seed` (for default admin)
- [ ] Run `npm install`
- [ ] Run `cd public/tailadmin && npm install`
- [ ] Run `npm run build`
- [ ] Run `php artisan serve`
## Features
### Frontend Site Builder
- Create multiple sites with custom layouts
- Drag-and-drop components into page content
- Visual layout builder with GrapesJS
- Monaco editor for code editing with syntax highlighting
### Component System
- Reusable components organized by category
- Component variables for dynamic content
- Easy insertion via `$component_code` syntax
### Dynamic Permissions
- Automatic permission generation for models
- Guard-based permission system
- Blade directives for permission checking
## Project Structure
```
app/
├── Http/
│ ├── Controllers/
│ │ ├── Backend/ # Admin controllers
│ │ └── Frontend/ # Frontend user controllers
│ ├── Helpers/ # MenuHelper, SettingHelper
│ ├── Middleware/ # Admin, User, Auth middleware
│ └── Requests/Backend/ # Form requests
├── Models/
│ ├── Backend/ # Admin models
│ └── Traits/ # Visitable, HasVisits
├── Services/ # BladeSyncService, PortalHandler, etc.
├── Observers/ # ActivityObserver
└── View/Composers/ # PublicMenuComposer, FrontendUserMenuComposer
resources/views/
├── backend/ # Admin panel (TailAdmin theme)
│ ├── auth/ # Login pages
│ ├── layouts/ # Layout + sidebar partials
│ └── module/ # Module CRUD views
├── frontend/ # CMS Builder output (cms.blade.php)
└── vendor/ # Published vendor views
public/
├── tailadmin/ # Admin assets
└── vendor/monaco-editor/ # Code editor
```
## Troubleshooting
### Asset Not Loading
```bash
php artisan storage:link
npm run build
```
### Permission Denied Errors
```bash
chmod -R 775 storage bootstrap/cache
```
### Database Connection Failed
- Verify database server is running
- Check credentials in `.env`
- Ensure database exists
## License
MIT License