# Finqu Headless Commerce Theme

A modern Next.js 16 storefront theme for Finqu headless commerce, featuring an integrated visual page builder powered by [Puck](https://puckeditor.com/).

## Quick Start

```bash
# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start
```

## Project 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

[Learn about Visual Editing →](./visual-editing)

### Developer Experience

- TypeScript support
- Hot module replacement
- Component documentation
- Testing utilities
- Deployment guides

## Getting Started

Ready to start with Nexus? Follow our installation guide.

[Installation Guide →](./installation)

## Documentation

- [Architecture Overview](./architecture) - Understand the theme's structure and data flow
- [Templates](./templates) - Learn how templates work for different resource types
- [Blocks](./blocks) - Build custom visual editor components
- [Data Fetching](./data-fetching) - Use the Finqu SDK for API calls
- [Multi-Locale Support](./multi-locale) - Configure and use multiple locales
- [Visual Editing](./visual-editing) - Use the Puck editor
- [Environment Variables](./environment-variables) - Configure your storefront
- [Troubleshooting](./troubleshooting) - Common issues and solutions