mirror of
https://github.com/RayLabsHQ/gitea-mirror.git
synced 2026-10-19 01:31:01 -05:00
The site moved to pnpm in July 2025 and pnpm-lock.yaml is the lockfile kept up to date, but www/bun.lock was left behind and still pins Astro 5. The Cloudflare Pages build image now installs with bun when it finds a bun.lock, and bun install --frozen-lockfile stops on the stale file, so every docs build has failed since. Remove it, ignore it in www so a local bun install cannot bring it back, and point the site README and CLAUDE.md at pnpm.
Gitea Mirror Marketing Site
This Astro workspace powers the public marketing experience for Gitea Mirror. It includes the landing page, screenshots, call-to-action components, and the new use case library that highlights real-world workflows.
Developing Locally
pnpm install
pnpm dev
The site is available at http://localhost:4321. Tailwind CSS v4 handles styling; classes can be used directly inside Astro, MDX, and React components.
Project Structure
src/pages/index.astro– Main landing pagesrc/components/– Reusable UI (Header, Hero, Features, UseCases, etc.)src/lib/use-cases.ts– Central data source for use case titles, summaries, and tagssrc/pages/use-cases/– MDX guides for each use case, rendered withUseCaseLayoutsrc/layouts/UseCaseLayout.astro– Shared layout that injects the header, shader background, and footer into MDX guides
Authoring Use Case Guides
- Add or update a record in
src/lib/use-cases.ts. This keeps the landing page and library listing in sync. - Create a new MDX file in
src/pages/use-cases/<slug>.mdxwith theUseCaseLayoutlayout and descriptive frontmatter. - Run
pnpm devto preview the layout and ensure the new guide inherits global styles.
Deployment
The marketing site is built with the standard Astro pipeline. Use pnpm build to generate a production build before deploying.