Pomme Website

The official Pomme website — built with Astro 5, powered by Bun, and styled using Tailwind CSS v4.

---

Getting Started

How to get the project running on your local machine for development.

Prerequisites

• Bun

Local Development

1. Clone the repository. If you plan to make changes, create a fork first!

   git clone https://github.com/PommeMC/pomme-website.git
   cd pomme-website

2. Install all required dependencies.

   bun install

3. Start the development server.

   bun run dev

   The site will be available at http://localhost:4321

Building

bun run build

This command builds a production-ready deployment into the dist directory. These files are ready to be deployed on Cloudflare Pages.

Preview the production build

bun run preview

Project Structure

website/
├─ src/
│  ├─ pages/         # Astro route files
│  ├─ components/    # Astro & Svelte components (islands)
│  ├─ layouts/       # Shared layout templates
│  ├─ styles/        # Tailwind v4 theme tokens
│  └─ content/       # Markdown or MDX content
├─ public/           # Static assets (favicon, icons, etc.)
├─ astro.config.mjs  # Astro configuration
└─ package.json

Development Notes

This project uses Astro 5, which introduces faster rebuilds, partial hydration improvements, and first-class hybrid rendering.

Svelte is used for dynamic islands and component interactivity.

Tailwind v4 leverages the new @theme token system for consistent color and typography design.

Bun handles dependency management and script execution, replacing Node for faster dev cycles.

Pages are statically generated by default, with selective SSR where necessary.

Contributing

Fork the repository and create a new branch:

git checkout -b feat/my-change

Make your edits and run locally:

bun run dev

Ensure the build passes:

bun run build

Submit a pull request targeting the main branch.

License

The supporting code is GPL-3.0 licensed.