Step-by-Step Usage Guide

A full tutorial detailing every tool, button, and command in the correct order of usage.

1. Launching the Main Application

[Required] The main application is your primary hub for discovering leads and managing the pipeline.

cd "E:\All In One App"
python main.py

2. Configuring the Application

[Required] Before using any tools, click the ⚙ Settings button in the top right.

• Google Places API Key: Used for Lead Discovery.
• Cloudflare API Token / Account ID / Zone ID: Used for hosting sites via Wrangler.
• Cloudflare Domain: Used as the base URL for demo deployments.
• Export / Import: Buttons to backup or restore your database and API keys.

3. Lead Discovery

[Optional] Skip this if you already have a specific business or client you are creating a site for.

• Niche: Enter the target business type (e.g., plumber).
• Latitude / Longitude / Radius: Enter coordinates and search radius.
• Run Discovery: Fetches businesses and adds them to the queue.
• Save Preset: Save your current parameters for quick re-use.

4. Lead Evaluation

[Required if using Discovery] Manually evaluate the businesses found during discovery.

• ✗ PASS (Left Arrow): Rejects the lead.
• ★ EXAMPLE (Up Arrow): Downloads the site into example_sites/ for AI style reference.
• ✓ COPY (Right Arrow): Downloads the site using WebCopy and adds it to your Active Sites Pipeline.

5. Pipeline: Working a Site

[Required] The pipeline tracks each site's progress. Click the buttons in order from left to right.

Demo (AI Rebuild)

[Required]

• Button: "Start"
• Action: Launches Claude to completely rebuild the site in a modern style, maintaining content.

Copy Check 1 (C-CHK 1)

[Optional]

• Button: "Start"
• Action: Runs the copyright detection program for stock images. This tool scans the images downloaded from the original website against stock image libraries to detect copyrighted material that must be replaced before publishing.

Host Demo (HOST)

[Required]

• Button: "Start"
• Action: Deploys the site to a Cloudflare Pages project (e.g., site-name.demos.yourdomain.com).

Cold Call

[Optional]

• Button: "Start" / "Open"
• Action: Scrapes the original website for contact info (Phone, Email, Socials) and displays it in a popup so you can pitch the demo.

Form Response (FORM)

[Optional]

• Button: "Start"
• Action: Opens a file dialog. Select a .txt file containing client feedback or requested changes, and Claude will apply them to the site.

Copy Check 2 (C-CHK 2)

[Optional]

• Button: "Start"
• Action: Re-runs the stock image copyright detection program after form iterations, ensuring no new copyrighted images were introduced.

Iterate

[Optional]

• Button: "Reiterate"
• Action: If the client has further feedback after the Form step, upload another .txt file to trigger another AI modification round.

Host Final (HOST FINAL)

[Required]

• Button: "Publish"
• Action: Prompts you for the final apex domain (e.g., clientdomain.com), creates a new production Pages project, and sets up the DNS.

Email Provisioning (EMAIL)

[Optional]

• Button: "Provision"
• Action: Connects to Purelymail to create a contact@clientdomain.com mailbox and automatically configures MX records in Cloudflare.

SEO Enhancement Window (SEO)

[Optional]

• Button: "Start"
• Action: Opens the comprehensive SEO management suite with the following tabs:
  • Audit Tab: Runs an AI-powered SEO scan (Haiku) or manual fallback checks to score Technical SEO, Local SEO, AI/GEO readiness, and Performance.
  • Keywords Tab: Input target keywords to analyze keyword coverage across page titles, headers, descriptions, and paragraphs.
  • Report Tab: Generates a client-facing SEO report and publishes it to the `client-docs` Cloudflare project to share via URL. Also generates an `llms.txt` file for the site.
  • AI Enhancement Tab: Uses Claude Opus 4.7 to re-write and enhance site code based on audit findings. Features a "Enhance to 100% (loop)" button that continuously iterates until all categories hit 100%. Allows providing context notes like phone numbers and addresses.
  • Original Site Tab: Audits the downloaded original site and compares its scores and findings directly against the new AI-rebuilt site to prove value.

Folder Icon (Tools & AI Editing)

[Optional]

• Button: "📁" (Folder Icon on the far right of the pipeline row)
• Action: Clicking this opens a popup menu with four options:
  • Open in File Explorer: Opens the site's folder in Windows Explorer.
  • Open Terminal Here: Opens a terminal in the site folder. Use this to manually run the CLI editor by typing claude --dangerously-skip-permissions.
  • Open in Visual CMS: Launches the Visual CMS for this site.
  • Open in AI Designer: Directly opens the AI Designer for the site.

6. Additional Management Tools

✦ Build from Scratch

[Optional] Found in the top toolbar next to Settings. If you aren't cloning an existing site, use this tool to generate a brand new one.

• Action: Opens a dialog where you define a Name, Slug, Context Folder (containing assets), Original URL (optional), Existing Demo Folder (optional) to copy a site directly, a Niche Example Folder dropdown for style reference, and a Claude Prompt text area for editing the final prompt before building. The AI builds a site using your provided assets or local placeholder images.

+ Add Existing Site

[Optional] Found in the top toolbar.

• Action: Opens a dialog to import a site that already has downloaded or edited folders into your Active Sites Pipeline.

7. Visual CMS (Asset Replacement)

[Optional] When you need to replace placeholder images or swap structural assets without breaking code. You can launch it from the folder icon popup or manually:

python visual_cms.py

• Top Bar: Includes options to Load HTML Site, Toggle Layout, Desktop View, Mobile View, and Package Site.
• Left Pane (Preview): See the live HTML rendering of the site.
• Middle Pane (Drop Targets): Shows thumbnails of every image currently in the site. Drag a new image onto the grey drop target to replace it. An automatic cropper will ensure the aspect ratio is locked to prevent layout breakage.
• Right Pane (Content Browser): Load a local folder of images or search Unsplash, Pexels, and Pixabay to drag and drop from.