Version 4.1.2

PageWright

User's Guide

A complete reference manual for the PageWright code editor. Covers installation, site connections, file editing, live preview, AI features, and everything in between.

First Edition β€” March 2026
For PageWright v4.1.2 on Windows 10/11
Contents
Table of Contents
Getting Started
Chapter 1Installation & First Launch Chapter 2Connecting to Your Website Chapter 3A Tour of the Interface
Working with Files
Chapter 4Editing Files Chapter 5Live Preview & Visual Editing Chapter 6Managing Your Files Chapter 7Find & Replace
Safety & Publishing
Chapter 8Backups & Restore Chapter 9Publishing Your Site
AI Features
Chapter 10AI Chat & Security Scanner Chapter 11SEO/GEO Engine
Reference
Chapter 12Advanced Features & Troubleshooting Appendix AKeyboard Shortcuts Appendix BFrequently Asked Questions Appendix CMCP Server & AI Coding Assistants Appendix DGlossary IndexIndex of Topics
β€” ii β€”
Chapter 1
Installation & First Launch

Welcome to PageWright! This chapter will guide you through downloading, installing, and launching the application for the first time. By the end, you'll have PageWright running on your computer and ready to connect to your website.

What You'll Need

Choosing Your Installation Method

PageWright comes in three flavors. Pick the one that suits you best:

MethodBest ForHow It Works
Windows InstallerEveryday useInstalls like any app. Creates Start Menu and Desktop shortcuts. Includes uninstaller.
Portable VersionTrying it out, USB drivesA single .exe file. Double-click to run β€” nothing gets installed. Delete to remove.
Node.js (a JavaScript runtime that lets you run apps outside a browser)Mac/Linux users, developersRun the source with Node.js 18+. Opens in your browser. Works on any platform.

Installing the Windows Version

  1. Visit pagewright.net and click the Download button. Choose the Windows Installer.
  2. When the download finishes, double-click PageWright Setup 4.1.2.exe to run the installer.
  3. Follow the on-screen prompts. Choose an installation directory (the default is fine for most people).
  4. When the installer finishes, PageWright will be in your Start Menu and on your Desktop.
If Windows SmartScreen shows a warning, click "More info" then "Run anyway." This happens because PageWright is new and hasn't yet built up a reputation with Microsoft's signing service. The software is safe.

Using the Portable Version

  1. Download PageWright-4.1.2-portable.exe from pagewright.net.
  2. Put the file anywhere you like β€” your Desktop, a USB drive, a shared folder.
  3. Double-click to run. That's it!

To remove the portable version, simply delete the file. There's nothing to uninstall.

Running with Node.js

If you're on macOS or Linux (or prefer the browser-based experience), you can run PageWright as a local web app:

  1. Make sure you have Node.js 18 or newer installed. You can check by opening a terminal and typing: node --version
  2. Download and unzip the PageWright source package.
  3. Open a terminal in the pagewright folder and run:
    npm install   # npm = Node Package Manager, a tool for installing JavaScript packages
    npm start
  4. Your browser will open to http://localhost:3000. PageWright is running!

The Welcome Screen

When PageWright starts for the first time, you'll see the Quick Start Guide β€” a short walkthrough of the basics. Read through it, then click "Get Started" to dismiss it.

Behind the guide is the Welcome Screen, which shows two buttons:

Once you've saved site connections, they'll appear here for quick access. Your most recently used sites appear first.

The Welcome Screen also displays a decorative background image behind the buttons, giving the page a polished look before you connect to a site.

Launch PageWright now. Take a moment to look around the Welcome Screen. Notice the two big buttons and the empty "Your Sites" area on the left. In the next chapter, we'll fill that with your first site connection.
β€” 1 β€”
Chapter 2
Connecting to Your Website

PageWright connects to your web server using industry-standard file transfer protocols. This chapter explains how to set up your first connection, how to find your credentials, and how to choose the right protocol.

What You'll Need

To connect to your website, you'll need these details from your hosting provider:

Not sure where to find these? Check your hosting provider's welcome email β€” it's almost always in there. You can also find them in your hosting control panel (cPanel, Plesk — a web hosting management dashboard — etc.) under "FTP Accounts" or "SSH Access."

Understanding Protocols

PageWright supports three ways to connect to your server. Here's the plain-English version:

ProtocolPort (communication channel number)SecurityPlain English
FTP21NoneThe original. Like sending a postcard β€” anyone on the network could read it. Use only on trusted networks.
FTPS990SSL/TLS (encryption protocols that secure data in transit)FTP wrapped in encryption. Like sending a letter in a sealed envelope. Most traditional web hosts support this.
SFTP22SSHA completely different system that uses SSH tunneling. The most secure option. Supported by modern hosts, VPS, and cloud servers.
When in doubt, try SFTP first. It's the most widely supported secure protocol. If that doesn't work, try FTPS. Only use plain FTP if nothing else works and you understand the risks.

Adding Your First Site

  1. Click "Connect to Site" on the Welcome Screen (or click the connection badge in the top-right corner).
  2. Enter a Site Name β€” this is just a label for your own reference. Something like "My Blog" or "Client: Smith Co."
  3. Enter the FTP Host β€” your server address.
  4. Choose your Protocol (SFTP recommended). The port will auto-fill.
  5. Enter your Username and Password.
  6. Optionally, enter a Starting Directory β€” like /public_html or /var/www. This tells PageWright which folder to open when you connect.
  7. Optionally, enter your Site URL β€” like https://www.yoursite.com. This enables the Live Preview feature (Chapter 5).
  8. Click Connect.

If everything is correct, you'll see your site's file tree appear on the left side of the screen. Congratulations β€” you're connected!

Saving and Switching Sites

PageWright automatically saves your connection details (your password is encrypted β€” see below). The next time you open PageWright, your saved sites appear on the Welcome Screen. Just click one to reconnect.

To switch between sites while working, click the connection badge in the top-right corner. It shows your current site name and a dropdown of all saved sites.

Working with Local Folders

You don't need a server to use PageWright. Click "Open Local Folder" on the Welcome Screen to edit files directly on your computer. This is perfect for:

When you're ready to go live, use the Publish feature (Chapter 9) to upload your local files to a remote server.

Password Security

Your passwords are encrypted using AES-256-GCM (Advanced Encryption Standard with 256-bit keys in Galois/Counter Mode) β€” the same encryption standard used by banks and governments. The encryption key is generated uniquely on your machine and never leaves your computer. Your credentials are only sent when connecting to your server β€” never to PageWright or any third party.

Never share your .pagewright-key file with anyone. This is the encryption key for your stored passwords. Each PageWright installation generates its own unique key.
Connect to your website now. If you don't have a web server, try Open Local Folder instead β€” pick any folder on your computer that has HTML files. Navigate through the file tree and click on a few files to see them in the editor.
β€” 2 β€”
Chapter 3
A Tour of the Interface

PageWright's interface is divided into several main areas. Let's walk through each one so you know where everything is.

The Title Bar & Menus

PageWright uses a custom title bar that combines the window controls, menus, and toolbar into a single compact row. At the top left, you'll see the PageWright logo and version number. Next to that are the HTML menus β€” File, Edit, View, Tools, and Help β€” which give you access to every feature in the app.

The right side of the title bar has the standard window controls (minimize, maximize, close). The entire title bar area acts as a drag handle to move the window.

The Toolbar

After the menus, a row of quick-access buttons gives you one-click access to the most common tools:

ButtonWhat It Does
πŸ’Ύ SaveSaves the current file (uploads it to your server). Same as Ctrl+S.
πŸ” Find in SiteOpens the search bar for finding (and replacing) text across your entire site.
βœ“ ValidateSwitches the preview pane to show HTML/CSS validation results.
🎨 ColorsExtracts and displays every color used in your file.
↻ RefreshRefreshes the preview pane.
πŸ‘ PreviewCycles the preview pane between three modes: right of editor, below editor, or hidden. Ctrl+Shift+P.
πŸ—„ BackupsOpens the backup browser for the current file.
πŸ”— Check LinksScans your entire site for broken internal links.
πŸš€ PublishUploads local files to your remote server (only visible for local folders).
πŸ“ Spell CheckToggles spell checking on or off. Misspelled words appear with wavy underlines.

The File Tree (Left Panel)

On the left side of the screen is your site's file structure. Folders can be expanded by clicking the arrow icon, or double-clicking the folder name. Files open in the editor when double-clicked. The tree auto-adjusts its width to accommodate long filenames.

At the bottom of the file tree, you'll see connection information β€” your server address and protocol.

The Editor (Center)

The main area is the code editor β€” powered by Monaco, the same engine used in Visual Studio Code (a popular free code editor made by Microsoft). Files open in tabs across the top, so you can have multiple files open at once.

The editor provides syntax highlighting for 50+ languages, auto-completion, bracket matching, and all the features you'd expect from a professional code editor. We'll cover these in detail in Chapter 4.

The Preview Pane (Right Panel)

To the right of the editor is the preview pane, which has several tabs:

TabWhat It Shows
PreviewA live rendering of your HTML as you type.
πŸ“Ž RefsAll file references (links, images, scripts, stylesheets) found in your code.
ValidateHTML and CSS validation errors and warnings, plus one-click W3C (World Wide Web Consortium) standards checking.
ColorsEvery color value extracted from your file.
LinksResults of the broken link checker.
πŸ›‘ SecurityAI-powered security vulnerability scanning.
πŸ’¬ ChatAI assistant β€” describe changes in plain English and apply them to your code.
🌐 LiveYour actual live website rendered in the pane.
πŸ”Ž InspectShows computed CSS properties for the element you clicked in the preview.

The Command Palette

Press F1 (or choose View → Command Palette) to open the command palette β€” a quick-search overlay that gives you instant access to 40+ commands without reaching for your mouse. Just start typing to fuzzy-filter (match results even when your text isn't exact) the list, then use the arrow keys and Enter to execute.

Commands are organized by category: File, Search, View, Tools, Theme, and Help. It's the fastest way to reach features like switching themes, opening responsive preview, toggling panels, or running tools.

Responsive Preview

Choose View → Responsive Preview (or search for it in the command palette) to activate a device-size preview bar above the preview pane. Click a preset to see how your page looks at different screen sizes:

PresetResolutionSimulates
DesktopFull widthNormal desktop monitor
Laptop1366 × 768Typical laptop screen
Tablet768 × 1024iPad portrait
Phone390 × 844iPhone 14 / modern Android
Phone S320 × 568iPhone SE / small screens

The preview scales to fit within the pane so you see the full page at the target device size.

The Status Bar

At the very bottom is the status bar. It shows the current filename, line/column count, file size, encoding (the character set used to represent text, such as UTF-8), file type, and connection status. It also displays a "Support PageWright" badge linking to the LemonSqueezy store; users who have already paid can dismiss it with the "✓ Already paid" link.

The Menu Bar

The menus (File, Edit, View, Tools, Help) are built-in HTML menus integrated into the title bar. They provide access to everything, including features not in the toolbar:

Explore each area. Click through the toolbar buttons and preview tabs. Try toggling the preview pane on and off with Ctrl+Shift+P. Press F1 to open the command palette and search for a command. Open the menus and browse the available options.
β€” 3 β€”
Chapter 4
Editing Files

This is where you'll spend most of your time. The PageWright editor gives you professional-grade code editing tools in a clean, focused interface.

Opening Files

Double-click any file in the file tree to open it. The file loads into a tab in the editor area. You can have multiple files open β€” just click between tabs to switch.

Both the file tree and the folder view use double-click to open files β€” consistent behavior throughout.

While a file is loading, the UI dims and disables clicking on the file tree, search results, and folder view β€” a file loading guard that prevents impatient re-clicking from causing confusion.

The Monaco Editor

PageWright uses the Monaco editor β€” the same engine that powers Visual Studio Code. Here's what it gives you out of the box:

Emmet Expansion

PageWright includes Emmet, a powerful tool for writing HTML and CSS quickly. Type a short abbreviation and press Tab to expand it into full code:

You TypeYou Get
div.container<div class="container"></div>
ul>li*5A <ul> with five <li> items
a[href="#"]<a href="#"></a>
!A complete HTML5 (the current version of the HTML standard) boilerplate (reusable template) document

Saving Your Work

Press Ctrl+S to save the current file. When connected to a server, this uploads the file immediately. A backup of the previous version is created automatically before each save (see Chapter 8).

The tab shows a yellow dot when you have unsaved changes. After saving, the dot disappears.

Linked Tag Editing

When you edit an HTML opening tag, the closing tag updates automatically. Change <div> to <section>, and the matching </div> becomes </section> without you having to find it.

Path Autocomplete

When typing file paths in src, href, or url() attributes, PageWright suggests files from your site. Type src=" and you'll see a list of images; type href=" and you'll see HTML files. This prevents typos and broken links.

Working with Multiple Files

Open as many files as you need β€” each gets its own tab. Use Ctrl+W to close the current tab. If you have unsaved changes, PageWright will ask before closing.

Open an HTML file and experiment. Try typing an Emmet abbreviation like div.test>p*3 and pressing Tab. Edit an HTML tag name and watch the closing tag update automatically. Press Ctrl+S to save.
β€” 4 β€”
Chapter 5
Live Preview & Visual Editing

One of PageWright's most powerful features is the ability to see your changes in real time, and even edit text directly in the preview.

Instant Preview

As you type HTML or CSS, the Preview tab updates automatically to show what your page looks like. There's a brief pause after you stop typing, then the preview refreshes. CSS changes from linked stylesheets are reflected too β€” PageWright caches and inlines them.

The Instant Preview works for HTML, CSS, PHP, and ASP (Active Server Pages, a Microsoft server-side technology) files. For other file types (JavaScript, JSON, text), the preview pane hides automatically to give you full-width editing space.

Click-to-Code

Click on any element in the preview, and PageWright jumps to the corresponding line in the editor. This is incredibly useful for large files β€” instead of scrolling through hundreds of lines, just click the element you want to change.

Visual Editing

For HTML files, the preview pane becomes content-editable. You can click directly on text in the preview and type to change it. Your edits sync back to the code automatically.

This is perfect for quick text corrections β€” fixing a typo in a heading, updating a phone number, changing a paragraph. No need to hunt through the code for the right spot.

Visual editing works best for text changes. For structural changes (adding elements, changing layouts), edit the code directly.

Live Server Preview

Click the 🌐 Live tab to see your actual live website rendered in the preview pane. This is especially useful for PHP files β€” the Instant Preview can only show the HTML structure, but Live Preview shows the fully rendered page from your server.

To use Live Preview, you need to enter your Site URL in the connection settings (e.g., https://www.yoursite.com).

CSS Preview

When editing a CSS file, the preview shows the HTML page that uses that stylesheet (if you've viewed it recently). You can see your CSS changes reflected in real time without switching back to the HTML file.

W3C Validation

Click the Validate tab to see PageWright's built-in checks (unclosed tags, deprecated elements (HTML tags that are outdated and no longer recommended), missing alt attributes). For a more thorough check, click the 🌐 W3C Check button at the top of the panel.

This sends your HTML to the official W3C Nu HTML Checker (the official online tool for validating HTML against web standards) β€” the same validator used by web standards professionals. It returns errors and warnings about heading hierarchy (the structured nesting of H1 through H6 headings), invalid nesting, accessibility issues, and more. Each result is clickable to jump to the relevant line in your editor.

W3C validation requires an internet connection. The built-in checks work offline.

Preview Layout

By default, the preview appears to the right of the editor. Click the πŸ‘ Preview button (or press Ctrl+Shift+P) to cycle through three modes:

  1. Right β€” preview alongside the editor (default, good for wide screens)
  2. Below β€” preview stacked under the editor (good for narrow screens or portrait monitors)
  3. Off β€” preview hidden for full-width editing

Your preferred layout is saved and restored when you reopen PageWright.

CSS Inspector

Click the πŸ”Ž Inspect tab in the preview pane, then click any element in the preview. The inspector shows the element's computed CSS (the final styles the browser actually applies) grouped into categories:

Color values show a visual swatch next to the value. Click Copy CSS to copy all displayed properties to the clipboard.

Open an HTML file and watch the preview. Type some text and see it appear in the preview. Click on an element in the preview to jump to its line in the editor. Try clicking on text in the preview and editing it directly. Then switch to the Validate tab and click W3C Check to see how your code measures up to web standards.
β€” 5 β€”
Chapter 6
Managing Your Files

PageWright isn't just a code editor β€” it's also a complete file manager for your website. You can create, rename, move, duplicate, and delete files and folders without leaving the application.

The File Tree

The left panel shows your site's folder structure. Click a folder to expand it and see its contents. Click again to collapse it. Files show colored icons based on their type (HTML, CSS, JS, PHP, images).

The Folder View

When you double-click a folder in the file tree, the main area shows a detailed folder view with columns for filename, size, and last modified date. Click any column header to sort by that column.

The folder view supports:

Right-Click Menu

Right-click on any file or folder (in either the tree or folder view) to access a context menu with these options:

Uploading Files

There are two ways to upload files:

  1. Drag and drop β€” drag files from Windows Explorer directly into the PageWright folder view
  2. Upload button β€” right-click a folder and choose "Upload Here"

Uploaded files appear in the folder view immediately.

Image Preview

Click an image file (PNG, JPG, GIF, SVG, etc.) to see it rendered in the preview pane with its dimensions displayed.

Image Editor

PageWright includes a built-in image editor so you can crop, resize, rotate, and adjust your images without leaving the application. No need to switch to a separate tool β€” make your edits right where you work.

Opening the Image Editor

There are two ways to open an image for editing:

The image opens full-pane with its own tab in the tab bar β€” just like a code file. An unsaved-changes indicator (*) appears when you've made edits. Click the on the tab to close it; if you have unsaved changes, PageWright will ask before discarding them.

Crop

Click Crop, then drag a selection rectangle over the part of the image you want to keep. Click Apply to crop the image to your selection, or Cancel to start over. Everything outside your selection is removed.

Resize

Click Resize to enter new Width and Height values. By default, the aspect ratio is locked β€” changing one dimension automatically updates the other so your image won't be stretched or squished. Uncheck the lock to resize each dimension independently. Click Apply when you're happy with the new size.

Rotate & Flip

These four buttons apply their changes immediately β€” no confirmation needed:

Brightness, Contrast & Saturation

Drag the Brightness, Contrast, and Saturation sliders to adjust the look of your image. Each slider ranges from -100 to +100, and changes preview live in real-time so you can see exactly what you're getting.

Color to Transparent

Need to remove a background color? Click Color → Transparent, then click any color in the image. That color β€” and similar shades β€” becomes transparent. Use the Tolerance slider (0–100) to control how many similar shades are included: a low tolerance removes only the exact color you clicked, while a higher tolerance catches nearby shades too. Click Clear to undo the transparency.

When you use this feature, PageWright saves the image as PNG to preserve the transparency.

Saving Your Edits

When you're happy with your changes:

Tip: The checkerboard background behind the image shows transparent areas. This makes it easy to see exactly where transparency has been applied β€” whether from the Color to Transparent tool or from a PNG that already had transparent regions.

Broken Link Checker

Click πŸ”— Check Links in the toolbar to scan your entire site for broken internal links. PageWright crawls all HTML and PHP files, finds every link and image reference, and checks whether the target file exists on your server.

Results appear in the Links tab in the preview pane. Each broken link shows the source file, line number, and the broken reference β€” click to jump directly to it.

Try the right-click menu. Right-click a folder and create a new file called test.html. Open it, type some HTML, and save it. Then right-click the file and try renaming it. Finally, run the Link Checker to see it in action.
β€” 6 β€”
Chapter 7
Find & Replace

Whether you need to find a specific line of code, track down where a CSS class is used, or replace a phone number across your entire site, PageWright has you covered.

Find in Current File

Press Ctrl+H to open Monaco's built-in Find & Replace bar within the current file. This supports:

Find in Site

Press Ctrl+Shift+F (or click πŸ” Find in Site in the toolbar) to open the site-wide search bar. Type your search term and press Enter. PageWright searches every file on your site and shows the results.

Each result shows the filename, line number, and a preview of the matching line. Click any result to open that file and jump to the exact line.

Replace Across Files

The search bar includes a Replace field. After searching, you can:

Replace All Checked is a powerful operation. PageWright creates backups before making changes, but double-check your search term and replacement text before clicking.

Scoped Search

Want to search only certain files or folders? Select them in the folder view (hold Ctrl to multi-select), then click πŸ” Find in Selected. The search will only look in the files and folders you selected.

Try a site-wide search. Press Ctrl+Shift+F, type a common word like "the" or a CSS class name, and hit Enter. Click through the results to jump to each match.
β€” 7 β€”
Chapter 8
Backups & Restore

Mistakes happen. A typo, a bad paste, an experiment gone wrong. PageWright's automatic backup system means you never have to worry about losing your previous work.

How Backups Work

Every time you save a file (Ctrl+S), PageWright automatically does two things:

  1. Downloads the current version of the file from your server
  2. Stores it as a timestamped backup on your local computer

Only then does it upload your new version. This means you always have the previous version safely stored.

Browsing Backups

Click πŸ—„ Backups in the toolbar to see all backups for the current file. Each entry shows the date and time it was saved. You can:

Where Backups Are Stored

Backups live on your local computer in the PageWright data folder, organized by site name and file path. They're just text files and take up minimal space.

Backups are stored on your computer, not on your server. If you switch to a new computer, your backups won't transfer automatically. Consider copying the backups folder from %APPDATA%\PageWright if you're migrating.
Think of backups as unlimited undo that works across sessions. Close PageWright, reboot your computer, come back next week β€” your backups are still there.
β€” 8 β€”
Chapter 9
Publishing Your Site

If you're working with a local folder, at some point you'll want to upload your files to a live web server. PageWright's Publish feature makes this effortless.

The Publish Button

When you're working on a local folder, a green πŸš€ Publish button appears in the toolbar. Click it to open the Publish dialog.

Setting Up Publishing

  1. Click πŸš€ Publish in the toolbar.
  2. If this is your first time publishing this folder, you'll need to set up a remote server. Enter your FTP/SFTP connection details β€” the same information from Chapter 2.
  3. Choose a remote directory on the server where files should be uploaded (e.g., /public_html).
  4. Choose a publish mode (see below).
  5. Click Publish.

Publish Modes

ModeWhat It Does
IncrementalOnly uploads files that have changed since the last publish. Fast and efficient β€” great for daily updates.
FullUploads every file in the folder. Use this for the first publish or when you want to ensure everything is in sync.
Incremental publish compares file modification dates to determine what's changed. It's much faster than a full publish β€” if you changed 2 files out of 200, only those 2 get uploaded.

Direct Editing (Without Publish)

If you connected directly to your server via FTP/FTPS/SFTP (not a local folder), there's no need to publish. When you press Ctrl+S, the file is uploaded to your server immediately. Your site is updated in seconds.

β€” 9 β€”
Chapter 10
AI Chat & Security Scanner

PageWright includes built-in AI features that use your own API key (a password-like credential that authenticates your requests to an online service). You can chat with an AI assistant to modify your code, and scan files for security vulnerabilities.

Setting Up AI

PageWright supports three AI providers. You need an API key from at least one:

ProviderModel UsedWhere to Get a Key
AnthropicClaude Sonnetconsole.anthropic.com
OpenAIGPT-4oplatform.openai.com
GoogleGemini 2.0 Flashaistudio.google.com

To add your key, go to Tools β†’ AI Settings / API Keys in the menu bar, or click the βš™ button in the Security tab. Enter your key and click Save. Keys are encrypted with AES-256 and stored locally.

If you have keys for multiple providers, click "Use This" next to the one you want active.

AI Chat

Click the πŸ’¬ Chat tab in the preview pane. Type a message describing what you want, and the AI will respond with code suggestions based on your current file.

Example prompts:

When the AI suggests a complete file replacement, you'll see a "βœ“ Apply to File" button on the code block. Click it to replace your editor content with the AI's version. You can always undo with Ctrl+Z.

The AI sees your current file content as context, so it can make targeted changes. Be specific about what you want β€” "add a contact form after the hero section" works better than "add a form."

Security Scanner

Click the πŸ›‘ Security tab, then click "Scan Current File." The AI analyzes your code and returns:

Click any vulnerability to jump to the relevant line in your code. Click the πŸ”§ Fix button on a vulnerability to have the AI generate a patch (a targeted code change that fixes a specific problem).

Applying Security Fixes

When you click πŸ”§ Fix, the AI generates a corrected version of your file. You'll see three options:

AI-generated code should always be reviewed before deploying to a live site. Use the Preview Diff feature to see exactly what changed, and test thoroughly. The AI is a helpful assistant, not a replacement for your own judgment.

API Key Security

Your API keys are encrypted with AES-256-GCM and stored locally. They are never sent anywhere except the provider's official API endpoint β€” the web address your app sends requests to β€” (e.g., api.anthropic.com, api.openai.com, or generativelanguage.googleapis.com). PageWright does not proxy your keys through any third-party service.

β€” 10 β€”
Chapter 11
SEO/GEO Engine

PageWright includes a built-in SEO (Search Engine Optimization) / GEO (Generative Engine Optimization) Engine that audits your pages for search engine optimization and AI discoverability. Access it from the πŸ“Š SEO/GEO preview tab (when a file is open) or from the πŸ“Š SEO/GEO button in the folder view toolbar (for site-wide tools without needing a file open).

SEO Page Audit

Click πŸ“Š SEO Scan to analyze the currently open HTML file. PageWright checks 20+ SEO signals and returns a score from 0 to 100 with severity-ranked issues:

Each issue includes a severity level (critical, high, medium, low), a description, and an πŸ€– AI Fix button. Clicking AI Fix sends the issue details to the AI Chat panel, where your configured AI provider suggests specific code changes you can apply with one click.

GEO (AI Discoverability) Scan

Click 🌐 GEO Scan to check how well your page is optimized for AI systems like ChatGPT, Claude, and Perplexity. GEO audits look for:

Site-Wide Audits

Click Scan All to crawl every HTML page on your connected site and produce an aggregate score. The results show per-page scores, a severity breakdown, and the most common issues across your site.

Click Consistency to check for cross-page issues like duplicate titles, orphan pages (pages with no internal links pointing to them), inconsistent navigation, and missing canonical tags (HTML elements that tell search engines which page version is the "official" one).

llms.txt Generator

Click πŸ“„ llms.txt to generate an AI-readable description of your website. This file helps AI systems understand your site’s purpose, structure, and content.

If an llms.txt file already exists on your site, PageWright shows its current content with options to edit or regenerate. The generator correctly handles sites with a starting directory (e.g., /wwwroot/), saving the file inside the configured directory rather than the FTP root.

Knowledge Base

Click πŸ“š Knowledge to manage a collection of SEO rules, tips, and article references that improve audit quality over time. You can:

SEO News

Click πŸ” News to fetch the latest SEO best practices from authoritative sources: Google Search Central, web.dev, Moz, Search Engine Land, Ahrefs, and Search Engine Journal. Configure the check interval (daily, weekly, biweekly, monthly) or turn it off entirely. A NEW badge appears when fresh news is available.

AI Digest

Click πŸ€– AI Digest to have your configured AI provider (Anthropic, OpenAI, or Google) analyze the latest SEO news. The AI selects the 3–10 most actionable articles, provides summaries, action items, urgency levels (πŸ”΄ Act Now, 🟠 Act Soon, 🟒 Good to Know, πŸ”΅ FYI), and tags. The best items are auto-saved to your Knowledge Base. If no AI key is configured, raw RSS (Really Simple Syndication, a format for delivering updates from websites) results are shown instead.

Tip: You don’t need a file open to use site-wide SEO tools. Click the πŸ“Š SEO/GEO button in the folder view toolbar to access Scan All, Consistency, llms.txt, Knowledge, News, and AI Digest.
β€” 11 β€”
Chapter 12
Advanced Features & Troubleshooting

Multiple Instances

You can open PageWright multiple times to work on different sites simultaneously. Each instance automatically finds an unused port (3000, 3001, 3002, etc.).

File Associations

The Windows installer registers PageWright as a handler for HTML, CSS, PHP, and ASP files. You can right-click a file in Windows Explorer and choose "Open with PageWright." If PageWright is already running, the file opens in the existing window.

Spell Checker

Click the πŸ“ Spell Check toolbar button to toggle spell checking. When enabled, PageWright checks your file for misspelled words and marks them with wavy underlines in the editor. Right-click a misspelled word to see spelling suggestions and apply a correction with one click.

To add a word to your custom dictionary (so it won't be flagged in the future), right-click and choose Add to Dictionary. Custom words are stored in custom-dictionary.txt in your PageWright data folder.

The spell checker skips code keywords, HTML tags, and CSS properties. It focuses on the human-readable text in your files.

Sitemap Generator

Choose Tools → Generate Sitemap (or use the command palette) to create a sitemap.xml file for your website. PageWright scans your site's file structure, finds all HTML and PHP pages (up to 6 levels deep), and generates a standards-compliant XML sitemap (a file that tells search engines which pages to crawl). The sitemap is saved to the root of your site.

Starter Templates

Choose File → New from Template to create a new page from one of 9 built-in templates. Templates include blank pages, landing pages, blog posts, portfolios, contact forms, and more. Use the search box to filter the list. The new file is created in the current folder.

Site Lock

When you connect to an FTP server, PageWright creates a lock to prevent other PageWright instances from connecting to the same server simultaneously. This avoids file conflicts when running multiple windows. If you try to connect to a server that's already open in another instance, you'll see a warning with the option to force-connect if needed.

Configuration Files

FilePurposeLocation
sites.jsonSaved connections (encrypted passwords)%APPDATA%\PageWright
secrets.jsonEncrypted API keys%APPDATA%\PageWright
.pagewright-keyEncryption master key%APPDATA%\PageWright
backups/File backup versions%APPDATA%\PageWright
notes/Per-site notes%APPDATA%\PageWright
prefs.jsonUser preferences%APPDATA%\PageWright

Per-Site Notes

The Notes panel lets you keep reminders, to-do items, and working notes for each site you manage. Notes are stored locally on your computer (not on your server) and persist across sessions.

Opening the Notes Panel

Note Scopes

Each note can be scoped to one of three levels:

The scope selector defaults to the currently open file, but you can change it with the dropdown next to the Add button.

Working with Notes

File Tree Badges

Any file or folder that has notes attached shows a small πŸ“Œ badge in the file tree, so you can see at a glance which items have notes without opening the Notes panel.

Notes are stored in the notes/ folder inside %APPDATA%\PageWright, organized by site name. Like backups, they live on your local computer and won't transfer automatically if you switch machines.

Troubleshooting

Can't Connect to My Server

Preview Shows Broken Images

Live Preview Shows a Blank Page

AI Chat Returns Errors

SmartScreen Warning on Install

β€” 12 β€”
Appendix A
Keyboard Shortcuts

File Operations

Ctrl+SSave current file (upload to server)
Ctrl+Shift+SSave all open files
Ctrl+WClose current tab

Editing

Ctrl+ZUndo
Ctrl+Shift+ZRedo
Ctrl+XCut
Ctrl+CCopy
Ctrl+VPaste
Ctrl+ASelect all
Ctrl+DSelect next occurrence of current word
Ctrl+/Toggle line comment
Alt+↑/↓Move line up/down
Ctrl+Shift+KDelete line
Ctrl+]Indent line
Ctrl+[Outdent line
Alt+ClickAdd cursor at click position
TabExpand Emmet abbreviation / Accept suggestion

Search

Ctrl+HFind & Replace in current file
Ctrl+Shift+FFind across all files
Ctrl+GGo to line number

View

Ctrl+Shift+PToggle preview pane
Ctrl+BToggle file tree
Ctrl++Zoom in
Ctrl+-Zoom out
Ctrl+0Reset zoom
Ctrl+Shift+NOpen new PageWright window
F11Toggle fullscreen
F1Open Command Palette
Press F1 to open the Command Palette β€” a fuzzy-search overlay with 40+ commands for quick access to every feature. PageWright also inherits all of Monaco's keyboard shortcuts.
β€” A β€”
Appendix B
Frequently Asked Questions

Is PageWright free?

Yes β€” PageWright is free to download and use with no restrictions, no time limits, and no feature locks. It uses a "pay what you want" model. A suggested $5 contribution helps support development, but it's entirely optional.

Does PageWright send my data anywhere?

No. PageWright runs entirely on your computer. The only network connections it makes are to your FTP/SFTP server, your site URL (for Live Preview), and AI provider APIs (only if you've configured an API key). There is no analytics, telemetry (automated collection and transmission of usage data), or phone-home behavior of any kind.

Is my password safe?

Yes. Passwords are encrypted using AES-256-GCM before being stored on disk. The encryption key is generated uniquely on your machine and never transmitted anywhere.

Can I use it for vibe coding?

Absolutely. Generate code with ChatGPT, Claude, Cursor, or any AI tool β€” paste it into PageWright, see it render in the preview, and save to upload it to your server. Or use the built-in AI Chat to make changes directly. Automatic backups mean you can experiment fearlessly.

Is this a replacement for Microsoft Expression Web?

Yes! PageWright was built as a modern replacement for Expression Web 4, which was discontinued in 2012. It preserves the same workflow β€” connect to FTP, browse files, edit with live preview β€” but with a modern editor, SFTP support, AI features, and active development.

Can I use it on Mac or Linux?

The desktop installer is Windows-only. However, you can run PageWright on any platform with Node.js 18+ by running npm start and opening it in your browser.

How does it compare to VS Code with an FTP extension?

PageWright uses the same Monaco editor engine as VS Code but is purpose-built for website editing. It includes live preview, file management, broken link checking, automatic backups, AI security scanning, and AI chat β€” all integrated with zero configuration.

What if I break something?

Every save creates an automatic backup. Click πŸ—„ Backups to browse and restore any previous version. It's like unlimited undo across sessions.

Can I work on multiple sites at once?

Yes. Save multiple site profiles and switch between them. You can also open multiple PageWright windows, each on its own port.

Do the AI features cost money?

The AI features in PageWright are free β€” but you need your own API key from an AI provider (Anthropic, OpenAI, or Google). These providers have their own pricing, and most offer free tiers or credits for new users. PageWright does not charge anything for the AI features themselves.

β€” B β€”
Appendix C
MCP Server & AI Coding Assistants

PageWright includes an MCP (Model Context Protocol) server that lets AI coding assistants read, write, and manage files on your connected sites. MCP is an open standard β€” any AI tool that supports it can use PageWright’s server. The server provides 20 tools for full site access and SEO/GEO auditing.

What Can an AI Assistant Do with PageWright?

Once connected, an AI assistant can:

All of this works over FTP, FTPS, SFTP, or local folder connections β€” the AI assistant doesn’t need direct access to your server.

Available Tools

File Management (11 tools)

SEO/GEO (9 tools)

How It Works

The MCP server communicates via stdio (standard input/output, a way for programs to exchange data via text streams). When PageWright is running, the server discovers its port automatically and routes requests through PageWright’s API. Passwords are never exposed β€” the server strips credentials from all responses.

Setup by AI Tool

Each AI tool has its own way of connecting to MCP servers. Below are instructions for the most popular ones. In every case, PageWright must be running for the MCP tools to work.

Claude Code (Anthropic)

Claude Code picks up MCP servers from a .mcp.json file. PageWright ships one in its project root. To use it:

  1. Open a terminal in the PageWright project folder (where mcp-server.mjs lives).
  2. Launch Claude Code. It reads .mcp.json automatically and registers PageWright’s tools.
  3. Ask Claude to list your sites, read files, or run an SEO audit β€” the tools appear automatically.

If you use Claude Code from a different folder, copy the .mcp.json file there and update the path to mcp-server.mjs.

The .mcp.json format:
{
  "mcpServers": {
    "pagewright": {
      "type": "stdio",
      "command": "node",
      "args": ["C:\\PageWright\\pagewright\\mcp-server.mjs"]
    }
  }
}
Update the path in "args" to match where you installed PageWright.

ChatGPT / OpenAI

ChatGPT supports MCP servers in its desktop app (macOS and Windows). To connect PageWright:

  1. Open ChatGPT desktop β†’ Settings β†’ Tools & Integrations (or Settings β†’ MCP Servers in newer versions).
  2. Click Add Server and enter a name like PageWright.
  3. Set the command to node and the argument to the full path of mcp-server.mjs (e.g., C:\PageWright\pagewright\mcp-server.mjs).
  4. Save. PageWright’s 20 tools will appear in ChatGPT’s tool list.

Gemini CLI (Google)

The Gemini CLI reads MCP configuration from a JSON settings file:

  1. Open or create ~/.gemini/settings.json (Linux/macOS) or %USERPROFILE%\.gemini\settings.json (Windows).
  2. Add a "mcpServers" section using the same format as .mcp.json above.
  3. Launch the Gemini CLI. It will pick up PageWright’s tools automatically.

Cursor

Cursor (an AI-powered code editor) supports MCP via its settings:

  1. Open Cursor β†’ Settings β†’ MCP.
  2. Click Add new MCP server, choose stdio as the type.
  3. Set the command to node and the argument to the path of mcp-server.mjs.
  4. Save and restart Cursor. The tools will be available in Cursor’s AI features.

Windsurf (Codeium)

Windsurf reads MCP configuration from a JSON file:

  1. Open Windsurf β†’ Settings and search for MCP.
  2. Add a new server with node as the command and the full path to mcp-server.mjs as the argument.
  3. Save. Windsurf’s AI assistant (Cascade) will use the tools when relevant.

Other MCP-Compatible Tools

Any tool that supports the MCP standard can connect to PageWright. The pattern is always the same:

  1. Find the tool’s MCP server configuration (usually in settings or a config file).
  2. Add a server entry with command: "node" and args: ["path/to/mcp-server.mjs"].
  3. Make sure the transport type is set to stdio.
  4. Ensure PageWright is running, then restart your AI tool.

Popular tools gaining MCP support include VS Code with the Copilot extension, JetBrains IDEs, Amazon Q, and Cline. Check each tool’s documentation for the latest MCP setup instructions.

MCP is an open standard that’s growing quickly. If your AI tool isn’t listed here, check its documentation for "MCP" or "Model Context Protocol" support β€” it may have been added since this guide was written.

Security Notes

β€” C β€”
Appendix D
Glossary

Quick reference for technical terms used in this guide.

AES-256-GCM: Advanced Encryption Standard with 256-bit keys in Galois/Counter Mode. A strong encryption method used by banks and governments.

API endpoint: The web address your app sends requests to when communicating with an online service.

API key: A password-like credential that authenticates your requests to an online service. Each AI provider issues its own keys.

ASP: Active Server Pages, a Microsoft server-side technology for building dynamic web pages.

Boilerplate: A reusable template or standard starting-point code, such as the HTML5 document skeleton generated by Emmet's ! shortcut.

Computed CSS: The final CSS styles the browser actually applies to an element, after resolving inheritance, cascading, and specificity.

Custom dictionary: A personal word list you build by adding terms the spell checker doesn't recognize. Stored in custom-dictionary.txt.

Canonical tags: HTML elements that tell search engines which version of a page is the "official" one. Used to avoid duplicate-content penalties.

Content Security Policy (CSP): A security setting that controls what resources (scripts, styles, images) a web page is allowed to load.

CSS Grid: A CSS layout system for arranging content in rows and columns. Useful for complex page layouts.

Deprecated elements: HTML tags that are outdated and no longer recommended by web standards. Examples include <font> and <center>.

Diff: A side-by-side comparison showing the differences between two versions of a file.

Encoding: The character set used to represent text. UTF-8 is the most common encoding on the web today.

Fuzzy filter: A search method that matches results even when your typed text isn't an exact match. Used in the Command Palette.

GEO (Generative Engine Optimization): The practice of optimizing your website so AI systems like ChatGPT, Claude, and Perplexity can find, understand, and cite your content.

Heading hierarchy: The structured nesting of H1 through H6 headings on a page. Proper hierarchy improves accessibility and SEO.

HTML5: The current version of the HTML standard, maintained by the W3C and WHATWG.

IP address: A numerical address identifying a device on a network, such as 192.168.1.1.

MCP (Model Context Protocol): An open standard that lets AI coding assistants connect to external tools and services. PageWright's MCP server gives AI tools access to your site files and SEO features.

Meta description: A short summary of your page placed in the HTML head. Search engines often display it in results listings.

Meta tags: HTML elements in the page head that provide information about the page, such as description, keywords, and viewport settings.

Node.js: A JavaScript runtime that lets you run applications outside a browser. PageWright uses it as its server platform.

npm: Node Package Manager, a tool for installing JavaScript packages and managing project dependencies.

Open Graph: A standard that controls how your page appears when shared on social media platforms like Facebook and LinkedIn.

Orphan pages: Pages with no internal links pointing to them. They are hard for users and search engines to discover.

Patch: A targeted code change that fixes a specific problem, often generated by AI tools.

PHP: A popular server-side programming language for building dynamic websites.

Plesk: A web hosting management dashboard, similar to cPanel. Used to manage domains, FTP accounts, and databases.

Port: A numbered communication channel on a server (like a door number). Common ports: 21 (FTP), 22 (SFTP), 990 (FTPS).

Sitemap: An XML file that lists all pages on your website, helping search engines discover and crawl them efficiently.

Site lock: A mechanism that prevents two PageWright instances from connecting to the same FTP server simultaneously, avoiding file conflicts.

Regular expressions: A pattern-matching syntax for advanced text searching. Supported in PageWright's Find & Replace.

RSS: Really Simple Syndication, a format for delivering news and updates from websites. Used by the SEO News feature.

Schema.org / Structured data: Standardized tags that help search engines understand your content. Used for rich results in search listings.

Semantic HTML: Using HTML elements that describe their meaning, like <article>, <nav>, and <section>, instead of generic <div> elements.

SEO (Search Engine Optimization): The practice of improving your website so it ranks higher in search engine results.

SSH: Secure Shell, a protocol for encrypted remote connections. SFTP runs over SSH.

SSL/TLS: Encryption protocols that secure data in transit between your computer and a server. FTPS uses SSL/TLS.

stdio: Standard input/output, a way for programs to exchange data via text streams. Used by the MCP server.

Telemetry: Automated collection and transmission of usage data. PageWright does not include any telemetry.

Template: A pre-built page layout you can use as a starting point for new pages, saving time on common designs.

Title tag: The HTML <title> element shown in browser tabs and search engine results.

Viewport: The visible area of a web page on a device's screen. Viewport meta tags control how pages scale on mobile devices.

Visual Studio Code: A popular free code editor made by Microsoft. PageWright uses the same Monaco editor engine.

W3C (World Wide Web Consortium): The international standards organization that develops specifications for HTML, CSS, and other web technologies.

W3C Nu HTML Checker: The official online tool for validating HTML against web standards, maintained by the W3C.

β€” D β€”
Index
Index of Topics
AES-256-GCM encryption β€” 2, 10
AI Chat β€” 10
AI providers β€” 10
API keys β€” 10
Automatic backups β€” 8
Bracket matching β€” 4
Command Palette β€” 3, A
Custom titlebar β€” 3
Broken link checker β€” 6
Click-to-code β€” 5
Code folding β€” 4
Color picker β€” 3
Connection settings β€” 2
CSS Inspector β€” 5
CSS preview β€” 5
Custom dictionary β€” 12
Drag and drop β€” 6
Emmet β€” 4
Encryption β€” 2, 10
Expression Web β€” B
File associations β€” 12
Find in Site β€” 7
File tree β€” 3, 6
Find & replace β€” 7
Folder view β€” 6
FTP β€” 2
FTPS β€” 2
Image editor β€” 6
Image preview β€” 6
Incremental publish β€” 9
Installation β€” 1
IntelliSense β€” 4
Keyboard shortcuts β€” A
Linked tag editing β€” 4
Live Preview β€” 5
Local folders β€” 2, 9
Menu bar β€” 3
Monaco editor β€” 4
Multi-cursor β€” 4
Multiple instances β€” 12
Password security β€” 2
Path autocomplete β€” 4
Portable version β€” 1
Preview layout (right/below/off) β€” 5
Preview pane β€” 3, 5
Publish β€” 9
Responsive Preview β€” 3
Right-click menu β€” 6
Saving files β€” 4
Security fixes β€” 10
Security scanner β€” 10
SFTP β€” 2
Site lock β€” 12
Sitemap generator β€” 12
Spell checker β€” 12
Starter templates β€” 12
Status bar β€” 3
Syntax highlighting β€” 4
Tabs β€” 4
Toolbar β€” 3
SEO/GEO Engine β€” 11
SEO page audit β€” 11
Glossary β€” D
GEO scan β€” 11
llms.txt generator β€” 11
AI Digest β€” 11
Knowledge base β€” 11
MCP server β€” C
AI coding assistants (MCP setup) β€” C
Troubleshooting β€” 12
Uploading files β€” 6
Validation β€” 3
Vibe coding β€” B
Visual editing β€” 5
Welcome screen β€” 1
β€” Index β€”

PageWright v4.1.2

A lightweight code editor with built-in FTP, FTPS, and SFTP support β€” plus local folder editing, live preview, AI chat, and security scanning. Free to download and use.

βœ“ Monaco editor (VS Code engine)
βœ“ FTP, FTPS, SFTP support
βœ“ Live side-by-side preview
βœ“ Visual preview editing
βœ“ Click-to-code navigation
βœ“ AI Chat assistant
βœ“ AI security scanner
βœ“ Multi-provider AI support
βœ“ One-click publish
βœ“ Automatic backups
βœ“ Broken link checker
βœ“ Find & replace across files
βœ“ Emmet abbreviation expansion
βœ“ Path autocomplete
βœ“ HTML/CSS + W3C validation
βœ“ Color picker
βœ“ Drag & drop file management
βœ“ AES-256-GCM encryption
βœ“ Multiple simultaneous instances
βœ“ Windows file associations
βœ“ Spell checker with custom dictionary
βœ“ Sitemap.xml generator
βœ“ Starter templates
βœ“ CSS Inspector

www.pagewright.net

Β© 2026 PageWright. Free to use β€” pay what you want.