Appearance

FluentCart Documentation ​

Live DocsPluginVitePress

Official user guides and developer documentation for FluentCart — a powerful, flexible WordPress e-commerce plugin built by WPManageNinja.

What is FluentCart? ​

FluentCart is a modern WordPress e-commerce solution that lets you sell physical products, digital downloads, subscriptions, and software licenses from a single plugin. It includes built-in marketing tools (order bumps, coupons), deep integrations with the Fluent suite (FluentCRM, FluentCommunity, FluentSupport, FluentAffiliate, FluentBooking), support for global tax & VAT rules, multiple payment gateways, and a clean reporting dashboard.

This repository contains the VitePress static site that powers docs.fluentcart.com.

Documentation Coverage ​

SectionWhat it covers
Getting StartedInstallation, activation, setup wizard, dashboard overview
Product Types & CreationPhysical, digital, licensed, bundle, subscription products; pricing, inventory, categories
Store ManagementOrders, refunds, order bumps, instant checkout, customers, advanced filters
Payments & CheckoutStripe, PayPal, Paddle, Mollie, Square, Razorpay, Flutterwave, Paystack, Authorize.net, Mercado Pago, Cash on Delivery
ShippingZones, shipping classes, packages
Tax & DutiesConfiguration, tax rates, EU VAT, tax filing
Marketing & Sales ToolsCoupons, order bumps
Customer DashboardProfile management, downloads, subscriptions
Reporting & AnalyticsRevenue, product, subscription, retention, future renewals reports
IntegrationsFluentCRM, FluentCommunity, FluentSupport, FluentAffiliate, FluentBooking, LearnDash, LifterLMS, Webhooks, Cloudflare Turnstile, Amazon S3, Cloudflare R2
Settings & ConfigurationStore, payment, cart & checkout, email, licensing, roles & permissions, features & add-ons
Customization & ThemesGutenberg blocks, Elementor widgets, Bricks builder, CSS customization, translations
MigrationEasy Digital Downloads (EDD) migration guide
Troubleshooting & SupportCommon issues, logs, how to get support
ChangelogFull release history

Developer API docs live at dev.fluentcart.com (separate repository).

Tech Stack ​

  • VitePress 1.6.4 — static site generator
  • ufo — URL utilities used in config.mjs
  • turndown — HTML → Markdown utility
  • All content is plain Markdown under guide/

Project Structure ​

.
├── .vitepress/
│   └── config.mjs           # Nav, sidebar, SEO (canonical, OpenGraph, JSON-LD), sitemap
├── guide/                   # All user-facing docs
│   ├── public/images/       # Images (.webp) — served at /images/...
│   ├── getting-started/
│   ├── product-types-creation/
│   ├── store-management/
│   ├── payments-checkout/
│   │   └── connecting-payment-gateways/
│   ├── shipping/
│   ├── tax-&-duties/
│   ├── customer-dashboard/
│   ├── marketing-sales-tools/
│   ├── integrations/
│   ├── reporting-analytics/
│   ├── settings-configuration/
│   ├── storage/
│   ├── customization-and-themes/
│   ├── migration/edd/
│   ├── troubleshooting-support/
│   └── changelog.md
├── developer/index.md       # Stub — links to dev.fluentcart.com
├── public/                  # Site-level assets (logos, robots.txt)
└── index.md                 # Home page

Local Development ​

Prerequisites: Node.js 18+

bash
# Install dependencies
npm install

# Start local dev server with hot reload
npm run docs:dev

# Production build → .vitepress/dist/
npm run docs:build

# Wipe cache + dist, then build fresh
npm run docs:clean-build

# Preview the production build locally
npm run docs:preview

The dev server starts at http://localhost:5173 by default.

Contributing ​

Adding a new page ​

  1. Create a .md file in the appropriate guide/<section>/ directory.
  2. Start the file with an # H1 title — no frontmatter needed.
  3. Add it to the sidebar in .vitepress/config.mjs under themeConfig.sidebar['/guide/'].
  4. Add any images as .webp files to guide/public/images/<section>/.
  5. Run npm run docs:dev to verify the page renders correctly.

Editing an existing page ​

Open the relevant .md file under guide/, make your changes, and verify locally with npm run docs:dev.

Style guidelines ​

  • Voice: Second person ("you"), present tense, action-first.
  • Headings: # page title → ## sections → ### subsections → #### procedural steps.
  • Links: Use clean internal URLs (/guide/section/page-slug) without .md or .html.
  • Images: Reference as /images/<section>/<file>.webp with descriptive alt text.
  • Bold: UI paths (**FluentCart → Settings**), button names, and field labels.
  • SEO: Handled automatically — do not add <meta> tags or JSON-LD manually.
Live documentationhttps://docs.fluentcart.com
Developer docshttps://dev.fluentcart.com
Plugin websitehttps://fluentcart.com
WPManageNinjahttps://wpmanageninja.com

License ​

Documentation content © WPManageNinja. All rights reserved.