Release History
A complete record of every pageflare release. The most recent version is always listed first.
v0.8.0
Section titled “v0.8.0”Released: April 2026 Type: Major feature release
PWA Platform
Section titled “PWA Platform”Full PWA support lands — turn any static site into an installable Progressive Web App, complete with push notifications, offline support, and per-user analytics.
Local PWA build (free):
pageflare pwa buildgenerates a web app manifest, service worker, icons (maskable + splash), and an SDK script from a single config file. No cloud account required.- Manifest supports shortcuts, share target, protocol handlers, display overrides, and localized names.
- Service worker ships with configurable runtime caching strategies (
cache-first,network-first,stale-while-revalidate,network-only), navigate-fallback allow/deny lists, background sync, and refresh-prompt flow. - Icon generator produces all required sizes including maskable and iOS splash screens from a single source file.
Cloud PWA dashboard (paid):
- Connect a site to pageflare with
pageflare pwa initand manage everything from a hosted dashboard. - Push notifications — compose, schedule, and send to web push subscribers across Chrome, Firefox, Edge, and Safari 16.4+.
pageflare pwa push send,pageflare pwa push list. - Install + engagement analytics — installs, launches, push opt-in rate, notification click-through.
pageflare pwa statsshows a 30-day summary from the terminal. - Install landing pages — branded, hosted install-walkthrough pages with iOS-specific guidance and 30+ language localization.
- Onboarding wizard — 9-step guided setup for first-time PWA users.
Free PWA tools (marketing site)
Section titled “Free PWA tools (marketing site)”Four standalone web tools at /tools/* — no signup required.
- PWA Icon Generator — upload one image, download every icon size (Android, iOS, maskable, favicon).
- PWA Manifest Builder — form-driven editor that outputs a valid
manifest.json. - PWA Screenshots Generator — produce the install-prompt screenshots required by stricter PWA installs.
- Maskable Icon Editor — visual editor to compose an icon that meets the Android maskable safe-zone spec.
Pricing overhaul — CLI + Cloud split
Section titled “Pricing overhaul — CLI + Cloud split”New unified /pricing page replaces the PWA-only pricing. Two products sold separately, with Cloud plans bundling the equivalent CLI license.
CLI tiers (annual license):
| Tier | Price | Seats | Sites |
|---|---|---|---|
| Free | $0 | 1 | unlimited |
| Solo | $79/yr | 1 | unlimited |
| Studio | $199/yr | 3 | unlimited |
| Agency | $399/yr | 10 | unlimited |
Cloud tiers (monthly / annual):
| Tier | Monthly | Annual | Sites | Pageviews/mo | Credits/mo |
|---|---|---|---|---|---|
| Free | $0 | — | 1 | 10k | 100 |
| Pro | $29 | $23 | 5 | 100k | 2,000 |
| Team | $99 | $79 | 25 | 1M | 10,000 |
| Enterprise | Custom | Custom | ∞ | ∞ | Negotiated |
- LLM commands on the CLI (
seo fix,geo fix,llm generate) support BYOK (OpenAI / Anthropic / Gemini keys) — no pageflare account required. Alternatively, buy credit packs ($15 per 1,000, valid 12 months) and let pageflare proxy the calls. - Cloud credits meter AI-powered features (GEO answer monitoring, LLM auto-fixes). Optimizer runs, PWA generation, and deterministic fixes never consume credits.
- Legacy
/pwa/pricingURL redirects to/pricing.
CLI licensing change — seo fix --auto and geo fix --auto
Section titled “CLI licensing change — seo fix --auto and geo fix --auto”Breaking for Free CLI users. Both commands now require a paid CLI license (Solo or higher). The deterministic --auto mode previously ran on Free; audits remain free. Reasoning: fix commands write to your site output, and reliable auto-fixes are part of the paid value. Audits (seo audit, geo audit) stay on the Free tier.
Account + dashboard
Section titled “Account + dashboard”- Team / project hierarchy with a switcher in the sidebar — organize work across multiple clients or products.
- GitHub OAuth login alongside email.
- Sidebar dashboard layout with profile, settings, and logout nav.
- User-sites management — add, list, remove, and get an embed script per site.
Marketing site + docs
Section titled “Marketing site + docs”- Mega-menu navbar with Product (4-card grid) + Platforms dropdowns, compact scroll-mode, and SVG vector icons.
- Rich mega-footer restoring all 6 social channels (Discord, YouTube, LinkedIn, GitHub, X, Bluesky).
- 12 new PWA feature pages under
/pwa/features/*covering manifest, service worker, install prompts, push, offline, analytics, install pages, theming, asset hardening, and more. - Restored content across feature and platform pages (WordPress, Vercel, Netlify, Cloudflare Pages, GitHub Pages, AWS S3, and self-hosted).
- Cinematic GSAP effects on the WordPress feature page for scroll-linked animations.
- Emoji icons on grid cards across 35+ pages for visual density.
- Brand lowercased: pageflare (was Pageflare) sitewide.
Built-in app analytics
Section titled “Built-in app analytics”- GA4 helper with pre-defined events for onboarding, upgrade, and PWA actions.
- Analytics script loads lazily on first user interaction — no main-thread cost before that.
Security
Section titled “Security”- Critical + high-severity issues from the code review resolved: auth session lookup direct via Better Auth (no self-fetch), modal portal isolation for team/project creation, absolute URLs in the PWA embed snippet, sidebar and PWA-routes layout fixes.
--autofix commands now point users to/pricingfor upgrade instructions.- PWA embed snippet builds absolute URLs using the user’s configured domain.
- Lucide
<Github>icon replaced with an inline SVG (removed upstream in lucide-react 1.8.0).
v0.7.0
Section titled “v0.7.0”Released: April 2026 Type: Feature release
pageflare Studio
Section titled “pageflare Studio”New local monitoring dashboard that shows site health over time. Studio ships as a separate binary (pageflare-studio) launched via the CLI.
- Multi-site overview — register sites, view trend charts, and drill into individual scans.
- Tabbed site detail — Trends / Scans / Pages views with filtering and live search.
- Per-page SEO analysis — inspect on-page metrics and findings for every tracked URL in a site.
- Scan detail — enhanced summary cards and category score bars.
- Alerts — notification channels wired to rule evaluation on every auto-saved scan.
- Launch with
pageflare studio(default port9876).
Site Monitoring
Section titled “Site Monitoring”New commands for registering sites and running recurring scans. Results auto-save to a local SQLite database (~/.pageflare/monitor.db) and feed Studio, trends, and alert channels.
pageflare sites add|list|remove|prune— manage the registry of monitored sites.pageflare schedule add|list|remove— register cron-based recurring scans. Use--every 6hshorthand or full--cronexpressions. Scans can mixspeed,seo, andgeotypes.- Schedules are written to the system crontab, so they persist across reboots.
pageflare speed,seo audit, andgeo auditnow auto-save results to the monitor DB when the target site is registered — no extra flags required.
Analytics Self-Hosting (Pro)
Section titled “Analytics Self-Hosting (Pro)”Five analytics providers can now be downloaded at build time and rewritten to a local path, bypassing adblockers and eliminating third-party DNS hops.
- Providers covered: Google Analytics (
gtag.js), Plausible, Fathom, Matomo, Simple Analytics. Enable withself_host_analytics: true(default). - Advanced transforms (opt-in):
analytics_minimal— replaces ~90KB ofgtag.jswith a ~1KBsendBeaconsnippet that posts directly to the GA4 Measurement Protocol.analytics_cookieless— keeps fullgtag.jsbut swaps cookie-based IDs for alocalStorageclient ID (cookie_flags: max-age=0).analytics_randomize_id— generates a fresh client ID on every page load. Zero cross-session tracking.analytics_adblocker_detect— injects a 3-second check that warns in the console ifgtag/plausible/fathom/_paqnever loaded.
- Scripts are rewritten to
/_analytics/{hash}.jsand matchingpreconnect/dns-prefetchhints for the original provider domains are stripped automatically.
Shared Asset Graph
Section titled “Shared Asset Graph”seo audit, geo audit, audit, and optimize now share a single cached AssetGraph via a new load_or_build_graph() helper. Subsequent audits on the same directory reuse the cache keyed by content hash — significantly faster when running multiple audit types back-to-back. Broken internal references detected during graph construction are surfaced as SEO findings.
Fixes & refactors
Section titled “Fixes & refactors”- Monitor writes now use transactions for consistency across scans, pages, and metrics.
html2mdconversion fixes for nested lists and code blocks.geo-optimizerLLM robots/theme analyzers tightened and deduplicated.- Shared utilities extracted across CLI commands;
Defaultderived where applicable.
v0.6.0
Section titled “v0.6.0”Released: March 2026 Type: Feature release
GEO Audit
Section titled “GEO Audit”New pageflare geo audit subcommand that scores your site for AI-readiness (Generative Engine Optimization). Analyzes pages against 22 rules across four categories and produces a 0–100 score with an A–F grade.
| Category | Rules | Max Points |
|---|---|---|
| Discoverability | AI crawler access in robots.txt, llms.txt presence and quality, sitemap, meta robots | 30 |
| Structured Data | JSON-LD presence and type coverage, FAQ/breadcrumb/identity schemas | 25 |
| Content Quality | Heading hierarchy, content depth, extractability, FAQ blocks, lists/tables, alt text, citation markers | 30 |
| Technical | Canonical URL, Open Graph tags, meta description, language attribute, HTTPS, hreflang | 15 |
- Local directory audit — scan your build output with
pageflare geo audit dist/. - Live URL audit — fetch and score a live page with
--url https://example.com. - Three output formats —
table(default, human-readable),json(machine-readable),markdown. - CI quality gate —
--fail-under 70exits with code 2 if the score is too low. - Site-level checks — validates robots.txt AI bot policies, llms.txt content quality, and sitemap presence.
- Unified path resolution — accepts a positional path argument (like
optimize) with auto-detection of framework and build output directory. Reads from a prior optimize output if one exists.
GEO Fix (Pro)
Section titled “GEO Fix (Pro)”New pageflare geo fix subcommand that uses an LLM to propose targeted improvements for GEO audit findings.
- Accepts a JSON audit report from
geo auditor runs the audit inline. - Writes fixes to the resolved output directory (same as
optimize), making the commands composable and idempotent. - Processes pages with the lowest scores first, up to
--max-fixeslimit.
SEO Audit
Section titled “SEO Audit”New pageflare seo audit subcommand that scores your site’s technical SEO across 20 rules and produces a 0–100 score with an A–F grade.
| Category | Rules | Max Points |
|---|---|---|
| Indexability | HTTP status, noindex detection, canonical URL, robots.txt validation | 15 |
| Meta & Structure | Title tag presence and length, meta description, viewport, H1, heading hierarchy | 35 |
| Link Architecture | Crawlable links, descriptive anchor text, canonical integrity, internal links, orphan pages | 25 |
| I18n & Media | Hreflang validation, image alt text, JSON-LD structured data, Open Graph completeness | 20 |
- Local directory audit — scan your build output with
pageflare seo audit dist/. - Two output formats —
table(default, human-readable) andjson(machine-readable). - CI quality gate —
--fail-under 70exits with code 2 if the score is too low. - Verbose mode —
--verboseshows all rules including passed ones. - Site-level checks — detects orphan pages not linked from any other page.
- Unified path resolution — accepts a positional path argument (like
optimize) with auto-detection of framework and build output directory.
SEO Fix (Pro)
Section titled “SEO Fix (Pro)”New pageflare seo fix subcommand that generates targeted patches for SEO audit findings.
- Accepts a JSON audit report from
seo auditor runs the audit inline. - Writes fixes to the resolved output directory (same as
optimize), making the commands composable and idempotent. - Processes pages with the lowest scores first, up to
--max-fixeslimit. pageflare seo runcombines audit and fix in one step.
SEO Fix (Free)
Section titled “SEO Fix (Free)”New pageflare seo fix --auto generates deterministic fixes without an LLM or API key.
- Generates WebSite and Organization JSON-LD schemas from page metadata.
- Adds canonical URL link tags to pages missing them.
- Generates Open Graph meta tags (og:title, og:url, og:type) from page titles.
- Shows estimated score improvement before writing files.
Page Speed Testing
Section titled “Page Speed Testing”New pageflare speed command measures real-world page performance via Google PageSpeed Insights.
- Lab metrics (Lighthouse): LCP, FCP, Total Blocking Time, CLS, Speed Index.
- Field data (CrUX p75): LCP, INP, CLS, FCP with color-coded Good/Average/Slow indicators.
--strategy mobile|desktopto test different device profiles.--format jsonfor machine-readable output.- Works without an API key (rate-limited) or with
GOOGLE_API_KEYfor higher limits.
New SEO Audit Rules
Section titled “New SEO Audit Rules”Three new rules added to pageflare seo audit:
| Rule | Category | What it checks |
|---|---|---|
readability-score | Meta & Structure | Flesch-Kincaid reading ease score — flags content below 50/100 |
image-dimensions | I18n & Media | Images missing width/height attributes (causes layout shift) |
image-lazy-loading | I18n & Media | Below-fold images missing loading="lazy" |
SEO Audit Output Formats
Section titled “SEO Audit Output Formats”pageflare seo audit now supports 6 output formats (previously only JSON and table):
| Format | Flag | Use case |
|---|---|---|
table | --format table (default) | Terminal-friendly display |
json | --format json | CI integration, programmatic use |
markdown | --format markdown | Documentation, reports |
github | --format github | PR comments, GitHub Actions |
html | --format html | Standalone report with dark/light mode |
sarif | --format sarif | GitHub Code Scanning, VS Code |
Broken Link Detection
Section titled “Broken Link Detection”pageflare seo audit now detects broken internal references in your build output. The report shows source files and their missing targets. Results are included in all output formats.
Unified Audit
Section titled “Unified Audit”pageflare audit now runs all three audit engines in a single command — performance, SEO, and GEO. No need to run them separately.
- Shows performance issues (images, CSS, JS, fonts, minification), SEO score with recommendations, and GEO score with AI-readiness findings.
- Combined JSON output via
--jsonincludes all three reports in one object. --fail-underflag checks both SEO and GEO scores for CI gating.- All three engines share a cached file analysis, so the combined audit is barely slower than running one alone.
Improvements
Section titled “Improvements”- Smaller default binary — optional components (WASM plugins for URL crawling and image processing) are no longer bundled by default, reducing binary size and compile time.
- Better markdown conversion — replaced the HTML-to-Markdown converter with a faster streaming engine. Produces cleaner output for llms.txt generation, especially for tables and code blocks.
- Shared analysis cache — running
seo auditthengeo audit(or vice versa) reuses cached file analysis, making the second command near-instant.
Bug Fixes
Section titled “Bug Fixes”- Fixed
pageflare seo auditandgeo auditfailing with “URL auditing is not available” when run from a project root without arguments. - Fixed Pro license not being recognized after
gen-license --install.
v0.5.0
Section titled “v0.5.0”Released: March 2026 Type: Major feature release
Site Audit
Section titled “Site Audit”New pageflare audit subcommand that scans your static site and reports performance issues with actionable recommendations.
| Category | Rules |
|---|---|
| Images | Missing lazy-loading, missing dimensions, no srcset, no alt text, no LCP preload |
| CSS | Unminified stylesheets, no critical CSS extraction, render-blocking background images |
| JavaScript | Unminified scripts, render-blocking scripts |
| Fonts | External Google Fonts, missing font-display, missing unicode-range, no subsetting, no preload |
| SEO | No llms.txt, no speculation rules, no preconnect hints, no SPA prefetching |
| WordPress | Editor bloat in static export, exposed wp-paths |
| Media | Unoptimized SVGs, YouTube embeds without facades, iframes without lazy-loading |
| Assets | No content hashing, no platform image optimization |
- Generates an HTML report with scores, charts, and per-page findings.
--jsonoutput for CI integration.- Timing breakdown shows how long each audit phase takes.
Image Optimization
Section titled “Image Optimization”- Responsive images — automatically generates srcset variants at multiple breakpoints with adaptive sizing.
- Format conversion — converts images to WebP and AVIF where supported.
- Disk cache — processed images are cached to avoid re-encoding on subsequent runs.
- Content deduplication — identical images are detected and deduplicated.
- Platform integration — Vercel, Netlify, and Cloudflare Pages image CDN support with automatic rewriting.
- Production mode for Cloudflare Pages —
--prodflag controls whether CDN image rewrites are applied. Without it, Cloudflare Pages builds skip CDN-specific URLs that only work with a custom domain. Stale CDN files from previous production builds are cleaned up automatically.
Analytics Self-Hosting
Section titled “Analytics Self-Hosting”Download and self-host third-party analytics scripts. Eliminates external requests and improves load times.
| Provider | Detection |
|---|---|
| Google Analytics | gtag.js, analytics.js |
| Plausible | plausible.js |
| Fathom | script.js from cdn.usefathom.com |
| Umami | script.js from analytics.umami.is |
| Matomo | matomo.js |
- Minimal mode — strips unnecessary tracking features to reduce script size.
- Cookieless mode — removes cookie-based tracking for GDPR compliance.
- Adblocker detection — optional fallback when analytics is blocked.
Managed robots.txt
Section titled “Managed robots.txt”Generate a robots.txt with Cloudflare-compatible content signal comments. Choose a policy preset to control how search engines and AI crawlers access your site.
| Policy | Search Crawlers | AI Crawlers | Use Case |
|---|---|---|---|
allow-all | Allow | Allow | Default — full access for all crawlers |
block-ai-training | Allow | Block | Allow search indexing, block AI training |
block-all-ai | Allow | Block | Allow search, block all AI usage |
block-all | Block | Block | Block all automated access |
- Configurable via
robots_policyinpageflare.jsoncwith optional per-signal overrides. - Emits
Content-signalcomments following the Cloudflare managed robots.txt convention. - Existing robots.txt files are never overwritten.
Markdown Content Negotiation
Section titled “Markdown Content Negotiation”- Pages are available as Markdown via
Accept: text/markdowncontent negotiation on the edge. - Vercel middleware and Netlify edge function generated automatically for supported platforms.
Font Fallback Stacks
Section titled “Font Fallback Stacks”- Metric-adjusted fallback fonts for 30 popular Google Fonts families — eliminates layout shift while web fonts load.
- Automatically injected into CSS
@font-facedeclarations.
Link Optimization
Section titled “Link Optimization”- External links get
rel="noopener noreferrer"automatically. - Configurable link obfuscation and CSS class injection.
Partytown Integration
Section titled “Partytown Integration”- Third-party scripts can be offloaded to a Web Worker using Partytown.
- Automatically detects eligible scripts and injects the Partytown runtime.
WordPress Plugin
Section titled “WordPress Plugin”- New WordPress admin plugin with tabbed interface for optimization settings.
- Setup wizard with auto-download of the CLI binary.
- Integration with Simply Static — auto-optimize after export with activity log.
- Export history, optimization presets, and health check dashboard.
Sitemap Generation
Section titled “Sitemap Generation”- Automatic
sitemap.xmlgeneration withlastmoddates extracted from page content. - Gzip-compressed sitemaps for large sites.
robots.txtintegration with automatic Sitemap directive.
JSON Minification
Section titled “JSON Minification”- JSON files in the build output are now minified automatically.
CLI Improvements
Section titled “CLI Improvements”- Input validation — the CLI now checks that the input is a non-empty directory with
index.htmlbefore running. pageflare audit— new subcommand for site performance audits.--platformflag — explicit platform selection for image optimization (auto, vercel, netlify, cloudflare-pages, none).- Smart path resolution — automatically detects project root and output directory from framework conventions.
Performance
Section titled “Performance”- Incremental content hashing — unchanged assets reuse cached hashes between runs. Hash phase drops from ~90ms to ~7ms on content-only changes.
- Incremental processing — only changed files and their dependents are reprocessed.
- All optimizations are idempotent — running pageflare multiple times on the same output produces identical results.
Bug Fixes
Section titled “Bug Fixes”- Fixed assets not written to output directory when rerunning after output was deleted.
- Fixed
font-display: swapnot applied to self-hosted Google Fonts CSS. - Fixed font preload injection missing fonts defined in external CSS files.
- Fixed dynamically-loaded assets being incorrectly renamed by content hashing.
- Fixed emoji loader detection breaking on minified HTML.
- Fixed critical CSS extraction failing on stylesheets with query strings.
- Fixed font 404s on subpages due to incorrect relative paths.
- Fixed Vercel middleware for Markdown content negotiation — resolved recursion on static assets, corrected file placement and route configuration for Build Output API v3.
- Fixed site audit falsely flagging SVG images and small images (icons, logos, avatars) for missing srcset.
pageflare v1.0.0
Section titled “pageflare v1.0.0”Released: March 2026 Type: New package — framework integrations
Framework Integrations
Section titled “Framework Integrations”A single pageflare npm package with native integrations for popular frameworks. Install once, add one line to your config — optimization runs automatically after every build.
| Integration | Hook | Usage |
|---|---|---|
| Vite | Post-build (closeBundle) | import pageflare from 'pageflare/vite' |
| Astro | Post-build (astro:build:done) | import pageflare from 'pageflare/astro' |
| Nuxt | Post-build (Nitro close) | modules: ['pageflare/nuxt'] |
| Next.js | Programmatic / npm script | import { optimizeNextExport } from 'pageflare/next' |
| Netlify | Build plugin (onPostBuild) | package = "pageflare" in netlify.toml |
- Vite plugin also works with SvelteKit, Remix, and SolidStart.
- Nuxt module supports
pageflareconfig key innuxt.config.ts. - Next.js integration supports
output: 'export'mode only. - All integrations share a common core — binary resolution is handled automatically via
@pageflare/cli. - The separate
@pageflare/netlifypackage has been removed — usepageflaredirectly.
v0.4.0
Section titled “v0.4.0”Released: March 2026 Type: Performance & optimization release
SVG Optimization
Section titled “SVG Optimization”- Inline SVGs in HTML are now optimized automatically — removes editor metadata, comments, and redundant attributes.
- Configurable via
optimize_svginpageflare.jsonc(enabled by default).
Font Subsetting
Section titled “Font Subsetting”- Font files (TTF, OTF, WOFF) are subset to only include characters used on the site.
- Subset fonts are re-encoded as WOFF2 for maximum compression.
- Icon fonts (Font Awesome, Material Icons, etc.) are automatically excluded from subsetting.
- Font unicode-range injection uses a single pre-computed character set for correct, consistent results.
WordPress
Section titled “WordPress”- WP-Hide path sanitization — renames
wp-content→content,wp-includes→includes, removeswp-adminreferences from static exports. - Gutenberg editor script removal — strips editor-only scripts that are unused on static sites. Frontend scripts (interactivity API, i18n, hooks) are preserved.
- Duplicate stylesheet removal — when multiple plugins load the same CSS file, the first is deferred and duplicates are removed entirely.
SPA Mode
Section titled “SPA Mode”- Fixed infinite recursion when clicking
#anchor links — hash-only navigation is now handled natively by the browser. - Explicit filtering of
mailto:,tel:,javascript:,data:, andblob:links.
Performance
Section titled “Performance”- Per-phase timing — CLI now shows a breakdown of time spent in each pipeline phase. Also available in
--jsonoutput for CI integration. - Parallel file writes — output files are written concurrently for sites with 200+ files.
- Faster processing — reduced per-file overhead across all processors, resulting in ~8% faster optimization.
- Font unicode-range fix — unicode-range injection now produces correct, consistent results across all CSS files.
Bug Fixes
Section titled “Bug Fixes”- Fixed single-quoted
hrefand HTML entities (&) in Google Fonts URLs not being detected. - Fixed dynamically-loaded assets (webpack chunks, Elementor conditionals) being incorrectly renamed by content hashing.
- Fixed 404 broken reference report including false positives from dynamic endpoints and WordPress admin paths.
Image CDN Providers (unpic)
Section titled “Image CDN Providers (unpic)”- 21 new image CDN providers: Imgix, Shopify, Appwrite, Cloudinary, Storyblok, IPX, ImageEngine, Supabase, Astro, Directus, Builder.io, Bunny, Kontent.ai, Contentful, WordPress, Uploadcare, Hygraph, Cloudimage, KeyCDN, Scene7, Contentstack.
- Cloudflare Pages platform provider with Image Resizing support.
v0.3.0
Section titled “v0.3.0”Released: March 2026 Type: Feature release
Edge Optimizer
Section titled “Edge Optimizer”On-demand optimization for live WordPress sites. Point your domain at pageflare and every page is automatically optimized on first visit — no build step required.
| Feature | Detail |
|---|---|
| Automatic optimization | Pages optimized on-demand when real visitors arrive — no crawling or manual triggers |
| Full optimization pipeline | Same multi-pass pipeline as the CLI: HTML/CSS/JS minification, lazy loading, image optimization, critical CSS, and more |
| Instant serving | Optimized pages served from edge storage worldwide with sub-millisecond routing |
| Smart caching | Content-addressed CSS and JS shared across pages — process once, serve everywhere |
| Cache purge API | Per-URL and full-site purge with WordPress plugin integration |
| WordPress plugin | Automatic cache purge on post publish, delete, theme change, and plugin activation |
| Image optimization | On-the-fly image resizing and format conversion at the edge (Pro) |
| Google Fonts self-hosting | Automatic download and self-hosting of Google Fonts files (Pro) |
| Site warm-up | Pre-optimize pages from your sitemap before traffic arrives (Pro) |
| Origin health monitoring | Real-time origin reachability checks with latency and SSL status |
WordPress Plugin
Section titled “WordPress Plugin”- Lightweight PHP plugin for automatic cache invalidation.
- Hooks into
save_post,delete_post,trash_post,switch_theme,activated_plugin, andwp_update_nav_menu. - Settings page with API key configuration and manual purge button.
--platformflag — explicitly set deployment target (vercel,netlify,auto,none).pageflare initpromoted from--initflag to dedicated subcommand.- Automatic project root and output directory detection for popular SSG frameworks.
Images
Section titled “Images”- CDN image detection — automatically detects images served from CDNs and generates responsive
srcsetusing the CDN’s native resize API. image_cdnconfig option — control CDN image optimization behavior (optimizeoroff).- Netlify image optimization support via
/.netlify/imagesAPI.
LLM Files
Section titled “LLM Files”llms.txtandllms-full.txtgeneration for AI-readable site content.- Subsection indexes for
/docs/and/api/folders. - Configurable
sub_indexesinpageflare.jsoncfor custom folder structure.
Bug Fixes
Section titled “Bug Fixes”- Fixed
vercel.jsonbeing written to scan dir instead of project root. - Fixed argument parsing for
pageflare initsubcommand.
v0.2.0
Section titled “v0.2.0”Released: March 2026 Type: Feature release
pageflare upgradesubcommand — self-updates the binary, or prints the right command for npm/Homebrew installs. Supports--forceto reinstall the current version.- Automatic update notifications after each optimize run (cached, 12-hour interval). Disable with
PAGEFLARE_TELEMETRY=false. - Subcommand dispatch —
pageflare optimizeis now an explicit subcommand (running barepageflarestill defaults to optimize).
Audit Page
Section titled “Audit Page”- Free live performance audit at pageflare.dev/audit.
- Current and estimated “after pageflare” scores for Performance, Accessibility, SEO, and Best Practices.
- Core Web Vitals display — LCP, CLS, INP, FCP, and TTFB.
- Actionable issue list showing which pageflare features fix each problem found.
Bug Fixes
Section titled “Bug Fixes”- Fixed argument parsing when using
pageflare upgradewith flags. - Improved accuracy of audit issue detection across all Lighthouse versions.
v0.1.0
Section titled “v0.1.0”Released: March 2026 Type: Initial stable release
pageflare 0.1.0 is the first public release. It delivers a production-ready post-build optimizer for static sites and WordPress, shipped as a single CLI binary backed by a Cloudflare Workers API.
HTML, CSS & JavaScript
Section titled “HTML, CSS & JavaScript”| Feature | Detail |
|---|---|
| HTML minification | Strips whitespace, comments, and redundant attributes |
| CSS minification | Shorthand collapsing, dead code removal |
| JS minification | Fast, standards-compliant minification |
Images
Section titled “Images”loading="lazy"and explicitwidth/heightinjected automatically.- Responsive
srcsetgeneration for adaptive sizing. - Vercel Image CDN integration for platform-optimized delivery.
font-display: swapadded to all@font-facerules.- Google Fonts self-hosting with
unicode-rangesubsetting.
Scripts & Navigation
Section titled “Scripts & Navigation”- Script deferral with
user-interactionanddeferstrategies. - Speculation Rules API injection for prefetch/prerender on same-origin links.
- SPA mode using the View Transitions API.
Critical CSS
Section titled “Critical CSS”- Per-page critical CSS extraction; above-the-fold styles inlined, remainder loaded async.
Video & Third-party
Section titled “Video & Third-party”- YouTube facade — lightweight click-to-load placeholder replaces embedded iframes at parse time.
WordPress
Section titled “WordPress”- Removes emoji script, query strings from asset URLs, and unnecessary
<head>meta noise.
Assets
Section titled “Assets”- Content-based asset hashing: filenames reflect file content for reliable long-lived caching.
pageflarebinary with JSONC config (pageflare.jsonc).--no-progressflag; non-TTY environments suppress progress output automatically.
Platform & Licensing
Section titled “Platform & Licensing”- Cloudflare Workers API, D1 (SQLite) for metadata, R2 for asset storage.
- Free tier and Pro tier licensing.
Future releases will appear above this line.