Finqu Headless Commerce Theme
A modern Next.js 16 storefront theme for Finqu headless commerce, featuring an integrated visual page builder powered by Puck .
Quick Start
# Install dependencies
pnpm install
# Start development server
pnpm dev
# Build for production
pnpm build
# Start production server
pnpm startProject Overview
This theme provides:
- Dynamic routing that resolves any URL to a Finqu resource (product, category, page, etc.)
- Visual page builder for customizing product pages, category pages, and custom pages
- Multi-locale support with automatic locale detection and switching
- Server-side rendering with Next.js App Router for optimal performance
- Type-safe API integration via
@finqu/storefront-sdk - Component library built with shadcn/ui and Radix primitives
Key Features
Visual Editing with Puck
Nexus integrates with Puck, allowing content editors to visually build and edit pages without code changes.
- Drag-and-drop page building
- Component library
- Real-time preview
- Content management
Developer Experience
- TypeScript support
- Hot module replacement
- Component documentation
- Testing utilities
- Deployment guides
Getting Started
Ready to start with Nexus? Follow our installation guide.
Documentation
- Architecture Overview - Understand the theme’s structure and data flow
- Templates - Learn how templates work for different resource types
- Blocks - Build custom visual editor components
- Data Fetching - Use the Finqu SDK for API calls
- Multi-Locale Support - Configure and use multiple locales
- Visual Editing - Use the Puck editor
- Environment Variables - Configure your storefront
- Troubleshooting - Common issues and solutions