A production-ready Laravel SaaS application that empowers users to create AI-assisted resumes and portfolio pages, download or share them as PDFs, and manage subscriptions via Stripe and PayPal.

### Technical Highlights
- Laravel 11+ framework
- Breeze authentication with email verification
- Role-based access control (Admin/User)
- DomPDF for PDF generation
- OpenAI/Groq API integration for AI features
- Clean MVC architecture with Service layer
- cPanel deployment ready
- Production-ready code with comprehensive documentation

- **AI-Powered Resume Builder**: Multi-step wizard with AI-assisted content generation
- **Portfolio Generator**: Create stunning portfolio pages with customizable sections
- **PDF Export**: Download resumes and portfolios as professional PDFs
- **Subscription Management**: Stripe and PayPal integration with automated billing
- **Admin Dashboard**: Complete user and analytics management
- **Responsive Design**: Tailwind CSS with dark mode support
- **SEO Optimized**: Public portfolio pages

- PHP 8.2 or higher
- Composer
- Node.js & NPM
- MySQL/PostgreSQL/SQLite
- (Optional) OpenAI or Groq API key for AI features
- (Optional) Stripe/PayPal credentials for payments

1. **Login to cPanel**
2. Navigate to **File Manager**
3. Go to your domain's root directory (usually `public_html` or `www`)
4. **Upload the ZIP file**
5. **Extract** the ZIP file using cPanel's extract feature
6. You should now have a Laravel project structure in your directory

***Laravel requires the web server to point to the `public/` directory:

***

## Option A: Using Subdomain (Recommended for Testing)
1. Create a subdomain (e.g., `app.yourdomain.com`)
2. Set its document root to `/home/username/public_html/your-laravel-app/public`

## Option B: Using Main Domain
*** Your index would be location at /public/index, /public/install***

1. Move all files from `public/` to `public_html/`
2. Move everything else to a directory outside `public_html/` (e.g., `/home/username/laravel`)
3. Edit `public_html/index.php` and update the following paths:
   require __DIR__.'/../laravel/vendor/autoload.php';
   $app = require_once __DIR__.'/../laravel/bootstrap/app.php';

All notable changes to AIResumePro.

## [1.2.1] - 2026-01-09
### Fixed - Language & Theme Switcher

- Fixed language switcher not changing page text
- Fixed dark/light theme toggle not switching theme properly
- Created ThemeMiddleware for reliable theme detection from user/session/cookie
- Added session-based theme persistence for immediate effect after toggle
- Excluded `locale` and `theme` cookies from Laravel encryption for proper middleware reading
- Updated LocaleMiddleware to check session in addition to user preference and cookies
- Theme toggle now reloads page for proper Tailwind class application
- Created JSON translation files (lang/en.json, es.json, fr.json, pt.json) for Laravel's `__()` helper
- Updated dashboard.blade.php with translation helpers for all text
- Added 100+ translation keys for dashboard, auth, profile, and common UI elements
- All four languages (English, Spanish, French, Portuguese) now translate UI elements 

- Multi-language support: English, Spanish, French, Portuguese
- Language switcher dropdown with flag emojis in navigation
- LocaleMiddleware for automatic language detection (user → cookie → default)
- Dark/light theme toggle using Tailwind class-based dark mode
- Theme and locale columns in users table for authenticated persistence
- Cookie-based persistence for guest users
- Mobile-responsive language/theme controls
- Translation files in lang/ directory 

### Added - Admin Dashboard Enhancements

#### Database Changes
- Added `site_settings` table for managing all site configurations (branding, SEO, general settings)
- Added `is_banned`, `banned_at`, `ban_reason` columns to `users` table for user ban functionality

- **Site Branding Manager**: Customize site name, tagline, logo, favicon, colors, and footer text
- **SEO Tag Manager**: Manage meta titles, descriptions, keywords, Google Analytics, Facebook Pixel, and custom scripts
- **User Management Enhancements**:
  - Create new users from admin panel
  - Ban/Unban users with optional reason
  - Toggle user registration on/off
  - Toggle email verification requirement
- **Resume Management**: View, search, and manage all user resumes from admin
- **Portfolio Management**: View, search, and manage all user portfolios from admin
- **Subscription Plan Management**: Create, edit, and delete subscription plans
- **Template Management**: Manage resume and portfolio templates
- **AI API Configuration**: Configure AI provider (OpenAI/Groq), model selection, and settings
- **Enhanced Analytics Dashboard**: Revenue charts, user growth, subscription metrics
- **Export Reports**: Export users, subscriptions, and revenue data as CSV

- New admin layout with sidebar navigation (`x-admin-layout` component)
- Mobile-responsive navigation with hamburger menu
- Admin Panel link in main navigation dropdown for admin users

- `SiteSetting` model with helper methods for getting/setting configuration values
- `AdminLayout` view component for admin pages

- `User` model now includes `isBanned()`, `ban()`, `unban()` helper methods

- All migrations are compatible with both MySQL and PostgreSQL
- Uses standard Laravel schema builder for cross-database compatibility
- No breaking changes to existing functionality</p>
<p>

- AI-Powered Resume Builder with multi-step wizard
- Portfolio Generator with customizable sections
- PDF Export for resumes and portfolios
- Stripe and PayPal subscription integration
- Basic Admin Dashboard with analytics
- Responsive design with Tailwind CSS and dark mode
- SEO optimized public portfolio pages
- Laravel Breeze authentication with email verification
- Role-based access control (Admin/User)