PR Agency Platform

Features

Public Site

Customizable homepage (hero, packages, publications)
Packages & publications catalog
Contact & quote request forms
Custom pages (About, Terms, Privacy)

Admin Dashboard

Leads CRM (contact & quote submissions)
Clients with portal invite
Projects with publications, documents, messages
Invoicing & Stripe checkout

Client Portal

Clients log in to view projects
Upload documents & send messages
Invite flow: admin invites by email

Settings & Config

Site name, logo, favicon
Stripe, SMTP, reCAPTCHA
Module marketplace (future)

Requirements

PHP 8.2+
Composer
Node.js & npm
MySQL, PostgreSQL, or SQLite

Installation

Option 1: Web Installer (Recommended)

Clone the repository: git clone https://github.com/onlineprfoundation/pr-agency-platform.git
Run: composer install, npm ci, npm run build
Visit your site — you'll be redirected to the installer
Follow: Requirements → Database → Administrator → Done

Option 2: cPanel / Shared Hosting

Create a MySQL database in cPanel, upload the built project, set document root to the public folder, then visit https://yourdomain.com/install.

See the full cPanel installation guide on GitHub.

Option 3: Manual

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan storage:link
npm ci && npm run build

Configuration

Most settings are configurable in Admin → Settings:

General — Site name, tagline, contact email, logo, favicon
Payment — Stripe keys, webhook secret, currency
Email — SMTP host, port, credentials
Homepage — Hero title, subtitle, CTA, section toggles
Security — Google reCAPTCHA for contact, quote, login forms

Deployment

The project includes a deploy.sh script for VPS deployment. For cPanel, build a ZIP with composer install --no-dev and npm run build, then upload and extract.

License

MIT License with attribution clause. You must retain the "Powered by Online PR" credit in the public footer.