Docs

Luminary Documentation

AI Website Generator for WordPress Last updated: May 2026 · Version 3.x · Support: info@jhpsunlimited.com

Quick Start

  1. Purchase a Luminary license at luminary.jhpsunlimited.com
  2. Download luminary-wordpress-client.zip from your purchase email
  3. Install on WordPress: Appearance → Themes → Add New → Upload Theme
  4. Activate — the setup wizard launches automatically
  5. Complete the 6-step wizard and click Generate
  6. Your complete website is live in about 60 seconds

Requirements

RequirementMinimum
WordPress6.4 or higher
PHP7.4 or higher
Anthropic API accountFree to create
FAL.ai API accountFree to create
HostingAny standard WordPress host

Luminary has been tested on WordPress 7.0 and PHP 8.3.

Installation

Installing the Theme

  1. Log into your WordPress admin dashboard
  2. Go to Appearance → Themes
  3. Click Add New → Upload Theme
  4. Choose the luminary-wordpress-client.zip file from your email
  5. Click Install Now
  6. Click Activate

The Luminary setup wizard launches automatically on first activation.

Getting Your API Keys

Luminary uses two AI services to build your website. Both are free to sign up for — you pay only for what you use (approximately $0.40 per site generation total).

Anthropic (Claude) — Brand copy and website content

  1. Go to console.anthropic.com
  2. Create a free account
  3. Go to API Keys → Create Key
  4. Copy the key (starts with sk-ant-)
  5. Add credits under Billing — $5 covers 10–15 site generations

FAL.ai — Hero image and video generation

  1. Go to fal.ai
  2. Create a free account
  3. Go to Dashboard → API Keys → Create Key
  4. Copy the key
  5. Add credits under Billing — $5 covers many generations at ~$0.30 each

Both API keys are entered in Step 2 of the Luminary wizard. They are encrypted and stored only on your own WordPress server — never transmitted to JHPS Unlimited.

The Wizard

Step 1 — License

Enter your Luminary license key from your purchase email. Click Activate License.

If you purchased on Gumroad, your key starts with GR-. Enter it exactly as shown in your email including the prefix.

Step 2 — API Keys

Enter your Anthropic and FAL.ai API keys. Click Save & Continue. Keys are encrypted immediately.

Step 3 — Business Information

Enter your business name, industry, and a 2–3 sentence description of what you do. Optionally add your address, phone number, and contact email — these populate your Contact page and help with local SEO.

Upload your logo if you have one (PNG, SVG, or JPG — max 2MB).

Step 4 — Brand & Style

Choose your visual preset, homepage layout, and site type:

Visual presets: Dark Luxury · Light & Clean · Bold Editorial · Warm Minimal · Tech Dark

Hero layouts: Full Bleed · Split · Centered · Minimal

Service layouts: 3-Column Grid · 2-Column Grid · List · Image Cards

Site types: Classic · Agency · Local Business · SaaS/Product · Personal Brand · Restaurant

Step 5 — Services

Add up to 6 services. Use short names — the AI writes the descriptions. You can optionally upload a thumbnail image per service.

Step 6 — Generate

Review your summary and click Generate My Website. The AI builds your complete site in about 60 seconds. You’ll be redirected to your live homepage automatically.

After Generation

Editing Your Copy

Go to Luminary → Edit Copy & Links to update any text the AI generated — headlines, subheadlines, taglines, about section, CTA text, and service URLs.

Edit any field and click Save & Apply to Live Site. Changes go live immediately.

Video Background

If your license includes video (Video tier or bundle), go to Luminary → Dashboard → Video Background and click Apply Video to Homepage.

Your hero image is animated into a slow cinematic video. If you see “Video not ready yet,” wait about 100 seconds and try again — FAL.ai is still rendering.

Adding More Services

Go to Luminary → Edit Copy & Links → Add a Service. Enter the service name, emoji icon, description, and optional link. Click Add Service to Site. No generation credit is used — you can add unlimited services this way.

Regenerating Your Site

Go to Luminary → Dashboard and click Regenerate Site to rebuild your entire website with new AI-generated content. This uses one generation credit.

License Tiers

FeatureStarterProAgencyDeveloper
Generation credits1050200/yrUnlimited
Sites15UnlimitedUnlimited
BYOK mode——✓Required
Video upgradeAdd-onAdd-onAdd-onAdd-on
AI provider choice———✓

Upgrading Your License

Purchase the upgrade tier and enter the new license key under Luminary → Settings → License. Your existing site stays live during the upgrade.

Adding Credits

Purchase a Credits 10-Pack and enter the credit key under Luminary → Settings → License. Credits are added instantly and never expire.

Video Upgrade

Purchase the Video Upgrade ($49) and enter the key under Luminary → Settings → License. Then apply the video from your Dashboard.

Developer & Agency — BYOK Mode

BYOK (Bring Your Own Keys) mode means your Anthropic and FAL.ai accounts are billed directly. There is no managed credit pool — you control costs entirely.

Switching AI Providers (Developer tier only)

Go to Luminary → Settings → AI Provider Settings to choose your providers:

Copy generation: Claude (default) · GPT-4o · Gemini 1.5 Pro · Groq Llama

Image generation: FAL.ai Flux (default) · DALL-E 3 · Stability AI · Replicate

Enter your chosen provider’s API key and click Save Provider Settings. The next generation uses your new provider.

wp-config.php Overrides

For programmatic configuration add these to wp-config.php before the /* That's all */ line:

php

define( 'LUMINARY_CLAUDE_MODEL', 'claude-sonnet-4-6' ); // default model
define( 'LUMINARY_MAX_TOKENS',   4096 );               // response length
define( 'LUMINARY_COPY_PROVIDER',  'openai' );         // developer only
define( 'LUMINARY_IMAGE_PROVIDER', 'replicate' );      // developer only

Troubleshooting

The wizard didn’t launch after activation Go to Luminary → Dashboard in the WordPress admin left menu and click Run Setup Wizard.

Brand generation failed / “AI returned incomplete response” Shorten your business description to 2–3 sentences. Go to Luminary → Dashboard, click Reset, then run the wizard again.

“No generation credits remaining” Purchase a Credits 10-Pack at luminary.jhpsunlimited.com/credits and enter the key under Settings → License.

My license key isn’t working Make sure you’re copying the full key including any prefix (GR- for Gumroad purchases). If the issue persists, email info@jhpsunlimited.com with your order number.

The site has a white edge or isn’t full width Go to Appearance → Customize → Additional CSS and add:

css

html, body { background: #080808 !important; margin: 0 !important; }
.lai-hero, .lai-services, .lai-about, .lai-cta-section, .lai-footer {
    width: 100vw !important; left: 50%; margin-left: -50vw !important;
}

Apply Video says “Video not ready yet” FAL.ai takes 90–120 seconds to render the video. Wait and try again. If it fails after 5 minutes, go to Dashboard → Regenerate and run a fresh generation.

Buttons I added to pages aren’t visible Go to Appearance → Customize → Additional CSS and add:

css

.wp-block-button__link {
    background: #C8A96E !important;
    color: #080808 !important;
    padding: 0.75em 1.5em !important;
    display: inline-block !important;
    border-radius: 4px !important;
}

YouTube embeds aren’t centered This is handled automatically in Luminary 3.x. If you’re on an older version, install the latest from your purchase email and use Replace installed with uploaded when prompted.

External Services

Luminary communicates with the following external services during website generation:

Anthropic (Claude API) — anthropic.com — Privacy Policy — Terms Your business name, description, industry, and services are sent to generate website copy.

FAL.ai — fal.ai — Privacy Policy — Terms An AI-generated image prompt (derived from your business info) is sent to generate your hero image and video.

Lemon Squeezy — lemonsqueezy.com — License key validation only. No personal data beyond the key is transmitted.

Gumroad — gumroad.com — License key validation for GR- prefixed keys only.

No data is sent to JHPS Unlimited servers during generation.

Changelog

v3.22.0 — Multi-provider AI support (Developer tier): GPT-4o, Gemini, Groq, DALL-E 3, Stability AI, Replicate

v3.21.0 — Dual license system: Gumroad (GR- prefix) and Lemon Squeezy keys both supported. Gumroad webhook for automatic credit/video unlocks

v3.20.0 — Save & Apply button with cache purge. View Live Site link with cache bypass

v3.19.0 — Copy editor hook names fixed — edits now apply to live site correctly

v3.18.0 — WP_Filesystem replaced with file_put_contents for REST context compatibility

v3.17.0 — Video apply restored to working version with 100-second wait messaging

v3.16.0 — Explicit Save & Apply button replaces auto-save. Service link Save buttons added

v3.15.0 — Trailing slash URL bug fixed — all REST saves now complete correctly

v3.12.0 — WordPress 7.0 get_page_by_path fix. Gutenberg block styles for page content

v3.10.0 — PHP 7.4 str_starts_with compatibility fix. Local template section preset fix

v3.7.0 — Full namespace isolation: lai_ client, laio_ owner — no conflicts between themes

v3.0.0 — Claude model corrected to claude-sonnet-4-6. image_prompt moved to first JSON field. max_tokens raised to 4096

Support

Email: info@jhpsunlimited.com Response within 1–3 business days, Monday–Friday

Coverage: Installation issues · License activation · Generation failures · Dashboard questions · Bug reports

Not covered: Custom theme modifications · Third-party plugin conflicts · WordPress hosting configuration · Anthropic or FAL.ai account issues (contact those providers directly)

JHPS Unlimited Richmond (Henrico), Virginia, USA