A complete reference manual for the PageWright code editor. Covers installation, site connections, file editing, live preview, AI features, and everything in between.
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.
PageWright comes in three flavors. Pick the one that suits you best:
| Method | Best For | How It Works |
|---|---|---|
| Windows Installer | Everyday use | Installs like any app. Creates Start Menu and Desktop shortcuts. Includes uninstaller. |
| Portable Version | Trying it out, USB drives | A 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, developers | Run the source with Node.js 18+. Opens in your browser. Works on any platform. |
To remove the portable version, simply delete the file. There's nothing to uninstall.
If you're on macOS or Linux (or prefer the browser-based experience), you can run PageWright as a local web app:
node --versionpagewright folder and run: npm install # npm = Node Package Manager, a tool for installing JavaScript packages npm start
http://localhost:3000. PageWright is running!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.
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.
To connect to your website, you'll need these details from your hosting provider:
ftp.yoursite.com or your server's IP address (a numerical address identifying a device on a network)PageWright supports three ways to connect to your server. Here's the plain-English version:
| Protocol | Port (communication channel number) | Security | Plain English |
|---|---|---|---|
| FTP | 21 | None | The original. Like sending a postcard β anyone on the network could read it. Use only on trusted networks. |
| FTPS | 990 | SSL/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. |
| SFTP | 22 | SSH | A completely different system that uses SSH tunneling. The most secure option. Supported by modern hosts, VPS, and cloud servers. |
/public_html or /var/www. This tells PageWright which folder to open when you connect.https://www.yoursite.com. This enables the Live Preview feature (Chapter 5).If everything is correct, you'll see your site's file tree appear on the left side of the screen. Congratulations β you're connected!
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.
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.
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.
.pagewright-key file with anyone. This is the encryption key for your stored passwords. Each PageWright installation generates its own unique key.PageWright's interface is divided into several main areas. Let's walk through each one so you know where everything is.
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.
After the menus, a row of quick-access buttons gives you one-click access to the most common tools:
| Button | What It Does |
|---|---|
| πΎ Save | Saves the current file (uploads it to your server). Same as Ctrl+S. |
| π Find in Site | Opens the search bar for finding (and replacing) text across your entire site. |
| β Validate | Switches the preview pane to show HTML/CSS validation results. |
| π¨ Colors | Extracts and displays every color used in your file. |
| β» Refresh | Refreshes the preview pane. |
| π Preview | Cycles the preview pane between three modes: right of editor, below editor, or hidden. Ctrl+Shift+P. |
| π Backups | Opens the backup browser for the current file. |
| π Check Links | Scans your entire site for broken internal links. |
| π Publish | Uploads local files to your remote server (only visible for local folders). |
| π Spell Check | Toggles spell checking on or off. Misspelled words appear with wavy underlines. |
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 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.
To the right of the editor is the preview pane, which has several tabs:
| Tab | What It Shows |
|---|---|
| Preview | A live rendering of your HTML as you type. |
| π Refs | All file references (links, images, scripts, stylesheets) found in your code. |
| Validate | HTML and CSS validation errors and warnings, plus one-click W3C (World Wide Web Consortium) standards checking. |
| Colors | Every color value extracted from your file. |
| Links | Results of the broken link checker. |
| π‘ Security | AI-powered security vulnerability scanning. |
| π¬ Chat | AI assistant β describe changes in plain English and apply them to your code. |
| π Live | Your actual live website rendered in the pane. |
| π Inspect | Shows computed CSS properties for the element you clicked in the preview. |
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.
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:
| Preset | Resolution | Simulates |
|---|---|---|
| Desktop | Full width | Normal desktop monitor |
| Laptop | 1366 × 768 | Typical laptop screen |
| Tablet | 768 × 1024 | iPad portrait |
| Phone | 390 × 844 | iPhone 14 / modern Android |
| Phone S | 320 × 568 | iPhone SE / small screens |
The preview scales to fit within the pane so you see the full page at the target device size.
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 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:
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.
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.
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.
PageWright uses the Monaco editor β the same engine that powers Visual Studio Code. Here's what it gives you out of the box:
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 Type | You Get |
|---|---|
div.container | <div class="container"></div> |
ul>li*5 | A <ul> with five <li> items |
a[href="#"] | <a href="#"></a> |
! | A complete HTML5 (the current version of the HTML standard) boilerplate (reusable template) document |
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.
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.
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.
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.
div.test>p*3 and pressing Tab. Edit an HTML tag name and watch the closing tag update automatically. Press Ctrl+S to save.
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.
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.
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.
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.
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).
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.
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.
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:
Your preferred layout is saved and restored when you reopen PageWright.
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.
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 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).
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 on any file or folder (in either the tree or folder view) to access a context menu with these options:
There are two ways to upload files:
Uploaded files appear in the folder view immediately.
Click an image file (PNG, JPG, GIF, SVG, etc.) to see it rendered in the preview pane with its dimensions displayed.
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.
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.
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.
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.
These four buttons apply their changes immediately β no confirmation needed:
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.
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.
When you're happy with your changes:
<img src="..."> references in your open HTML files to point to the new filename, so your pages stay in sync.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.
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.
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.
Press Ctrl+H to open Monaco's built-in Find & Replace bar within the current file. This supports:
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.
The search bar includes a Replace field. After searching, you can:
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.
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.
Every time you save a file (Ctrl+S), PageWright automatically does two things:
Only then does it upload your new version. This means you always have the previous version safely stored.
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:
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 folder from %APPDATA%\PageWright if you're migrating.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.
When you're working on a local folder, a green π Publish button appears in the toolbar. Click it to open the Publish dialog.
/public_html).| Mode | What It Does |
|---|---|
| Incremental | Only uploads files that have changed since the last publish. Fast and efficient β great for daily updates. |
| Full | Uploads every file in the folder. Use this for the first publish or when you want to ensure everything is in sync. |
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.
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.
PageWright supports three AI providers. You need an API key from at least one:
| Provider | Model Used | Where to Get a Key |
|---|---|---|
| Anthropic | Claude Sonnet | console.anthropic.com |
| OpenAI | GPT-4o | platform.openai.com |
| Gemini 2.0 Flash | aistudio.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.
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.
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).
When you click π§ Fix, the AI generates a corrected version of your file. You'll see three options:
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.
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).
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.
Click π GEO Scan to check how well your page is optimized for AI systems like ChatGPT, Claude, and Perplexity. GEO audits look for:
llms.txt file at the site rootClick 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).
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.
Click π Knowledge to manage a collection of SEO rules, tips, and article references that improve audit quality over time. You can:
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.
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.
You can open PageWright multiple times to work on different sites simultaneously. Each instance automatically finds an unused port (3000, 3001, 3002, etc.).
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.
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.
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.
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.
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.
| File | Purpose | Location |
|---|---|---|
sites.json | Saved connections (encrypted passwords) | %APPDATA%\PageWright |
secrets.json | Encrypted API keys | %APPDATA%\PageWright |
.pagewright-key | Encryption master key | %APPDATA%\PageWright |
backups/ | File backup versions | %APPDATA%\PageWright |
notes/ | Per-site notes | %APPDATA%\PageWright |
prefs.json | User preferences | %APPDATA%\PageWright |
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.
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.
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/ 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.https:// or http://| Ctrl+S | Save current file (upload to server) |
| Ctrl+Shift+S | Save all open files |
| Ctrl+W | Close current tab |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
| Ctrl+X | Cut |
| Ctrl+C | Copy |
| Ctrl+V | Paste |
| Ctrl+A | Select all |
| Ctrl+D | Select next occurrence of current word |
| Ctrl+/ | Toggle line comment |
| Alt+β/β | Move line up/down |
| Ctrl+Shift+K | Delete line |
| Ctrl+] | Indent line |
| Ctrl+[ | Outdent line |
| Alt+Click | Add cursor at click position |
| Tab | Expand Emmet abbreviation / Accept suggestion |
| Ctrl+H | Find & Replace in current file |
| Ctrl+Shift+F | Find across all files |
| Ctrl+G | Go to line number |
| Ctrl+Shift+P | Toggle preview pane |
| Ctrl+B | Toggle file tree |
| Ctrl++ | Zoom in |
| Ctrl+- | Zoom out |
| Ctrl+0 | Reset zoom |
| Ctrl+Shift+N | Open new PageWright window |
| F11 | Toggle fullscreen |
| F1 | Open Command Palette |
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.
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.
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.
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.
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.
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.
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.
Every save creates an automatic backup. Click π Backups to browse and restore any previous version. It's like unlimited undo across sessions.
Yes. Save multiple site profiles and switch between them. You can also open multiple PageWright windows, each on its own port.
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.
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.
Once connected, an AI assistant can:
llms.txt)All of this works over FTP, FTPS, SFTP, or local folder connections β the AI assistant doesnβt need direct access to your server.
pw_list_sites β List all saved site profilespw_connect_site β Connect to a site by namepw_list_files β List files in a directorypw_read_file / pw_write_file / pw_create_file β Read, write, and create filespw_upload_file β Upload binary files (images, etc.)pw_rename_file / pw_delete_file / pw_mkdir β Rename, delete, and create directoriespw_search β Search file contents across the siteseo_audit_page / seo_audit_site β SEO auditsseo_audit_geo β GEO (AI discoverability) auditsseo_crawl_site β Crawl and inventory a siteseo_check_consistency β Cross-page consistency checkseo_generate_llms_txt β Generate an AI-readable site descriptionseo_add_knowledge / seo_list_knowledge / seo_remove_knowledge β Manage the knowledge baseThe 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.
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 picks up MCP servers from a .mcp.json file. PageWright ships one in its project root. To use it:
mcp-server.mjs lives)..mcp.json automatically and registers PageWrightβs tools.If you use Claude Code from a different folder, copy the .mcp.json file there and update the path to mcp-server.mjs.
.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 supports MCP servers in its desktop app (macOS and Windows). To connect PageWright:
PageWright.node and the argument to the full path of mcp-server.mjs (e.g., C:\PageWright\pagewright\mcp-server.mjs).The Gemini CLI reads MCP configuration from a JSON settings file:
~/.gemini/settings.json (Linux/macOS) or %USERPROFILE%\.gemini\settings.json (Windows)."mcpServers" section using the same format as .mcp.json above.Cursor (an AI-powered code editor) supports MCP via its settings:
node and the argument to the path of mcp-server.mjs.Windsurf reads MCP configuration from a JSON file:
node as the command and the full path to mcp-server.mjs as the argument.Any tool that supports the MCP standard can connect to PageWright. The pattern is always the same:
command: "node" and args: ["path/to/mcp-server.mjs"].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.
localhost only β itβs not accessible over the network.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.
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.
Β© 2026 PageWright. Free to use β pay what you want.