95 lines
3.2 KiB
Markdown
95 lines
3.2 KiB
Markdown
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.
|