# Getting Started with Custom Storefronts

This guide will help you build your first custom storefront using Finqu's tools and APIs.

## Prerequisites

- Node.js 18+ installed
- A Finqu merchant account
- Basic familiarity with React and Next.js

## Quick Start Options

### Option 1: Start with Nexus Theme (Recommended)

The fastest way to get started is with the Nexus theme, which provides a complete Next.js storefront out of the box.

1. **Install the Finqu CLI** (if not already installed):

```bash
npm install -g @finqu/cli
```

2. **Sign in to your Finqu account**:

```bash
finqu sign-in
```

3. **Initialize a new storefront project**:

```bash
finqu storefront init
```

4. **Follow the prompts** to configure your storefront and select Nexus as your starting point.

5. **Start the development server**:

```bash
npm run dev
```

[Learn more about Nexus →](./nexus-theme/installation)

### Option 2: Build from Scratch

If you prefer to build a custom storefront from scratch:

1. **Set up a Next.js project**:

```bash
npx create-next-app@latest my-storefront
cd my-storefront
```

2. **Install the Storefront SDK**:

```bash
npm install @finqu/storefront-sdk
```

3. **Get your API key** - Obtain your Storefront API key from the Channel settings in the Finqu admin area. Keys are
   prefixed with `fq_` (e.g., `fq_OPmgGrIY...`).

4. **Configure the SDK** - Initialize the Storefront SDK with your API key:

```typescript
import { StorefrontClient } from "@finqu/storefront-sdk";

const client = new StorefrontClient({
  storeDomain: "your-store.finqu.com",
  apiKey: process.env.FINQU_STOREFRONT_API_KEY, // Store in environment variables
});
```

5. **Configure customer authentication** - Set up customer authentication flows.

[Authentication Guide →](./authentication)

6. **Connect to the Storefront GraphQL API** - Use the SDK to query products, manage carts, and handle checkout.

[Storefront SDK Documentation →](./storefront-sdk/overview)

## Next Steps

- [Explore Nexus Theme](./nexus-theme/overview) - Learn about the official theme
- [Set up Authentication](./authentication) - Implement customer authentication
- [Use the Storefront SDK](./storefront-sdk/overview) - Integrate with the GraphQL API
- [CLI Commands](/apis-and-tools/cli/storefront) - Manage your storefront with CLI

## Need Help?

- Check the [Storefront GraphQL API documentation](/apis-and-tools/storefront/overview)
- Review [API Reference](/reference/storefront/1.1.0)
- Contact support for assistance