> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prelaunch.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start Guide - PreLaunch Next.js Template

> Get up and running with PreLaunch Next.js landing page template in minutes. Step-by-step installation, configuration, and deployment guide.

## Installation

Follow these steps to get started with PreLaunch:

### 1. Clone the Repository

```bash theme={null}
git clone https://github.com/your-repo/prelaunch.git
cd prelaunch
```

### 2. Install Dependencies

Use your preferred package manager to install the dependencies:

```bash theme={null}
npm install
# or
yarn install
# or
pnpm install
```

### 3. Configure Environment Variables

Copy the `.env.local.example` file to `.env.local` and fill in the necessary environment variables:

```bash theme={null}
cp .env.local.example .env.local
```

Key environment variables:

```
# Basic configuration
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXTAUTH_SECRET=any_random_text
NEXTAUTH_URL=http://localhost:3000

# Authentication providers
## Google
GOOGLE_ID=your_client_id
GOOGLE_SECRET=your_client_secret

# Resend - Email service
RESEND_API_KEY=your_resend_api_key

# Paddle Billing configuration
PADDLE_API_KEY=your-api-key-here
NEXT_PUBLIC_PADDLE_CLIENT_TOKEN=your-paddle-client-token-here
PADDLE_NOTIFICATION_WEBHOOK_SECRET=your-webhook-secret-here
NEXT_PUBLIC_PADDLE_ENV=sandbox # or production

# Supabase configuration
NEXT_PUBLIC_SUPABASE_URL=your-supabase-url-here
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key-here

# Typeform configuration
NEXT_PUBLIC_TYPEFORM_VOTE_ID=your-typeform-vote-id
NEXT_PUBLIC_TYPEFORM_SUGGESTION_ID=your-typeform-suggestion-id
TYPEFORM_ACCESS_TOKEN=your-typeform-access-token
TYPEFORM_VOTE_FORM_ID=your-typeform-vote-form-id

# Google Analytics
NEXT_PUBLIC_GA_MEASUREMENT_ID=your-ga-measurement-id
```

### 4. Start the Development Server

```bash theme={null}
npm run dev
# or
yarn dev
# or
pnpm dev
```

Visit [http://localhost:3000](http://localhost:3000) to view your application.

## Basic Configuration

### Project Configuration

Edit the `config.ts` file to change the application name, description, domain, and other basic information:

```typescript theme={null}
const config = {
  // REQUIRED
  appName: "YourAppName",
  // REQUIRED: Short description of your app for SEO tags
  appDescription: "Your app description here",
  // REQUIRED (no https://, no trailing slash, just the naked domain)
  domainName: "yourdomain.com",
  // Other configuration...
}
```

### Customize Content

The project currently uses static content. You can directly modify the components to change text content.

Although the project structure still includes the `locales/` directory, the internationalization feature has been removed in the latest version. If you need multi-language support, you'll need to use Next.js's built-in internationalization features or add a third-party library.

### Style Customization

* Edit `tailwind.config.js` to customize colors, fonts, etc.
* Edit `styles/globals.css` to add custom CSS

## Deploying Your Project

### Build for Production

```bash theme={null}
npm run build
# or
yarn build
# or
pnpm build
```

### Deploy to Vercel

PreLaunch can be deployed to Vercel with one click:

<Card title="Deploy to Vercel" icon="rocket" href="https://vercel.com/new/git/external?repository-url=https://github.com/your-repo/prelaunch">
  Click to deploy to Vercel
</Card>

### Deploy to Netlify

You can also easily deploy to Netlify:

<Card title="Deploy to Netlify" icon="rocket" href="https://app.netlify.com/start/deploy?repository=https://github.com/your-repo/prelaunch">
  Click to deploy to Netlify
</Card>

## Technology Stack

PreLaunch uses the following technologies:

* **Frontend Framework**: [Next.js 14](https://nextjs.org/) (App Router)
* **UI Frameworks**:
  * [Tailwind CSS](https://tailwindcss.com/)
  * [DaisyUI](https://daisyui.com/)
  * [Radix UI](https://www.radix-ui.com/)
* **State Management**: React Hooks
* **Form Handling**: [React Hook Form](https://react-hook-form.com/) + [Zod](https://zod.dev/)
* **API Integrations**:
  * [Typeform](https://www.typeform.com/) - User voting and suggestion collection
  * [Resend](https://resend.com/) - Email sending
  * [Paddle](https://paddle.com/) - Payment processing and subscription management
* **Authentication**: [NextAuth.js](https://next-auth.js.org/)
* **Database**: [Supabase](https://supabase.com/) (PostgreSQL)

## Next Steps

* [Configuration](/customization/configuration) - Learn how to configure your application
* [Payment Integration](/features/payments) - Set up Paddle payments
