# 光尘网站

**Repository Path**: XII-idea/website

## Basic Information

- **Project Name**: 光尘网站
- **Description**: 壹贰光尘网站
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-06
- **Last Updated**: 2026-02-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# papermc.io [![Discord](https://img.shields.io/discord/289587909051416579.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/papermc) ![License](https://img.shields.io/github/license/PaperMC/website)

The official [PaperMC](https://papermc.io) website — built with **Astro 5**, powered by **Bun**, and styled using **Tailwind CSS v4**. Content in this repository is published to [papermc.io](https://papermc.io) for viewing.

---

## 🚀 Getting Started

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

### Prerequisites

- [Bun](https://bun.com/)

### Local Development

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

   ```bash
   git clone --branch feat/astro https://github.com/PaperMC/website.git
   cd website
   ```

2. Install all required dependencies.

   ```bash
   bun install
   ```

3. Start the development server.

   ```bash
   bun run dev
   ```

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

### Building

```bash
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

```bash
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
├─ tailwind.config.ts
├─ bun.lockb
└─ 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.

## 📚 Learn More

🌌 [Astro 5 Documentation](https://docs.astro.build)

🎨 [Tailwind CSS v4 Docs](https://tailwindcss.com/docs)

⚡ [Bun Docs](https://bun.sh/docs)

## 🛠️ Contributing

Fork the repository and create a new branch:

```bash
git checkout -b feat/my-change
```

Make your edits and run locally:

```bash
bun run dev
```

Ensure the build passes:

```bash
bun run build
```

Submit a pull request targeting the main branch.

## License

The supporting code is
[MIT](https://github.com/PaperMC/website/blob/main/LICENSE) licensed.

The PaperMC logomark is subject to its [own terms](https://docs.papermc.io/misc/assets) and does not
inherit a license from any of the projects it represents.