Publisher Scanner - Deployment Guide

Quick Start (5 minutes)

Files to Deploy

You need exactly 2 files (JavaScript is now built into the HTML):

index.html — the complete application
styles.css — all visual styling

Plus optionally: docs-readme.html, docs-features.html, docs-improvement.html, docs-ai-patterns.html, docs-deployment.html, docs-setup.html

Step-by-Step Deployment

1. Access cPanel File Manager

Log in to your cPanel account
Click File Manager in the main menu
Select public_html (or your desired directory)

2. Upload Files

Click the Upload button in the toolbar
Select all files from the zip
Wait for upload to complete
Verify each file shows in the directory listing

3. Set Permissions

Right-click each file → Change Permissions
Set to 644 (rw-r--r--)
Click Change

4. Access Your Application

Root directory: https://yourdomain.com/

Subdirectory: https://yourdomain.com/publisher-scanner/

Alternative Upload Methods

Via FTP

Host:     ftp.yourdomain.com
Username: your cPanel username
Password: your cPanel password
Port:     21
Directory: public_html/

Upload all files, then set permissions to 644 via your FTP client (right-click → CHMOD).

Via SSH

ssh username@yourdomain.com
cd public_html
# After uploading files via SCP:
chmod 644 index.html styles.css docs-*.html

First-Time Configuration

After uploading, open the app in your browser and go to Settings. Enter your Anthropic API key (from console.anthropic.com) and click Save Settings. The key is stored only in your browser's local storage — it never leaves your computer.

Troubleshooting

404 or Blank Page

Verify index.html and styles.css are in the correct directory
File names are case-sensitive — must be exactly index.html
Check file permissions are 644
Clear browser cache (Ctrl+Shift+Delete)

Styles Not Applying

Verify styles.css is in the same directory as index.html
Check styles.css permissions are 644
Clear browser cache completely
Open browser console (F12) and check for 404 errors on the CSS file

Scan Fails / API Error

Go to Settings and verify your Anthropic API key is saved
Ensure the key starts with sk-ant-
Check your API key has available credits at console.anthropic.com
Open browser console (F12 → Console) to see the exact error

Performance & Storage

Metric	Value
Page Load Time	< 1 second
Scan Time	5–15 seconds (live AI)
Memory Usage	< 50MB
Storage Per Scan	~5–10KB
History Capacity	20 scans (configurable)
Browser Support	All modern browsers

Common Issues Checklist

All files uploaded to correct directory
File permissions set to 644
File names are exactly correct (case-sensitive)
Browser cache cleared after upload
Anthropic API key saved in Settings
API key has available credits
No browser extensions blocking API calls
Tried in incognito/private mode to rule out extension conflicts

Backup & Updates

Backup: In cPanel File Manager, right-click your app folder → Compress → Download the .zip

Update: Download the new files, upload to the same directory (overwrite), clear browser cache.

← Back to Application

🚀 cPanel Deployment Guide