This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).

## Getting Started

First, run the development server:

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```

Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.

This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.

## Learn More

To learn more about Next.js, take a look at the following resources:

- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.

You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!

## Deploy on Vercel

The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.

Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

## Export Bundle (Landing ZIP)

The Builder can export a production-ready ZIP that contains:

- index.html, styles.css, app.js
- assets/ hashed assets (optionally grouped by type)
- site.webmanifest, robots.txt
- Optional: sheets/ (Google Apps Script template)
- Metadata files: assets.json, assets.index.json

### Export Options UI

- Manifest
  - Name, Short Name, Start URL, Display (dropdown), Theme Color (HEX only)
- Robots
  - Disallow lines (textarea). Each line becomes a `Disallow:` rule.
- Google Sheets Template Mode
  - Auto: include when `form.actionUrl` is empty
  - Include: always include
  - Exclude: never include

### site.webmanifest and robots.txt

- `site.webmanifest` is derived from page data; Export Options can override fields.
- `robots.txt` defaults to a permissive header and adds `Disallow` lines from UI.

### Asset paths and grouping

- AssetManager writes files to `assets/` with stable hash-based filenames.
- Path strategy can be configured:
  - `flat` (default): `assets/<hash>.<ext>`
  - `grouped`: `assets/images/...`, `assets/fonts/...`, `assets/other/...`

### assets.json

Structured metadata for all assets. Example fields per entry:

- originalName, mimeType, size
- hash8, ext, zipPath
- integrity: `sha256-<base64>` (placeholder, base64 of bytes)
- group: `images|fonts|other`
- referencedAt: array of `local:<originalName>` when referenced by the page

### assets.index.json

Simple index to quickly find assets by group:

- images: string[] of zip paths
- fonts: string[] of zip paths
- other: string[] of zip paths

### Google Sheets template (optional)

- When included, ZIP contains:
  - `sheets/Code.gs`: minimal Apps Script handler (Web App)
  - `sheets/README.txt`: setup instructions
- Inclusion is controlled by `sheetsMode` (Auto/Include/Exclude) and `form.actionUrl` in Auto mode.