Astro Migration

.github/workflows/check.yaml

@@ -0,0 +1,27 @@
+name: Checks
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+jobs:
+  lint:
+    # Only run on PRs if the source branch is on someone else's repo
+    if: ${{ github.event_name != 'pull_request' || github.repository != github.event.pull_request.head.repo.full_name }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Run linter
+        run: bun run check:all

.gitignore

@@ -1,39 +1,26 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+# build output
+dist/
 
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
+# generated types
+.astro/
 
-# misc
-.DS_Store
-*.pem
+# dependencies
+node_modules/
 
-# debug
+# logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-.pnpm-debug.log*
+pnpm-debug.log*
 
-# local env files
-.env*.local
+# environment variables
+.env
+.env.production
 
-# typescript
-*.tsbuildinfo
+# macOS-specific files
+.DS_Store
 
-# intellij
-/.idea
-*.iml
+# jetbrains setting folder
+.idea/
 
-# open-next
-.open-next
+.eslintcache

.prettierignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+bun.lock
+
+# Build outputs
+dist/
+.astro/
+.wrangler/
+
+# Cache
+.cache/
+
+# Logs
+*.log
+
+# Environment files
+.env
+.env.*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml

.prettierrc

@@ -0,0 +1,25 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "es5",
+  "printWidth": 140,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "plugins": ["prettier-plugin-astro", "prettier-plugin-svelte", "prettier-plugin-tailwindcss"],
+  "overrides": [
+    {
+      "files": "*.astro",
+      "options": {
+        "parser": "astro"
+      }
+    },
+    {
+      "files": "*.svelte",
+      "options": {
+        "parser": "svelte"
+      }
+    }
+  ]
+}

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,23 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+
+  "eslint.enable": true,
+  "eslint.run": "onSave",
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "astro",
+    "svelte"
+  ],
+
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "always",
+    "source.fixAll.eslint": "always"
+  },
+
+  "prettier.requireConfig": true,
+  "prettier.useEditorConfig": true,
+}

AGENTS.md

@@ -0,0 +1 @@
+README.md

LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -1,27 +1,118 @@
-# papermc.io
+# 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)
 
-## Development
+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
+---
 
-First, install the dependencies. We use [bun](https://bun.sh/) as the package manager.
+## 🚀 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 install
+bun run dev
 ```
 
-Then, run the development server:
+Ensure the build passes:
 
 ```bash
-bun dev
+bun run build
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+Submit a pull request targeting the main branch.
 
-### Learn More
+## License
 
-To learn more about technologies used in this project, take a look at the following resources:
+The supporting code is
+[MIT](https://github.com/PaperMC/website/blob/main/LICENSE) licensed.
 
-- [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.
-- [Tailwind CSS Documentation](https://tailwindcss.com/plus/ui-blocks/documentation) - learn about Tailwind CSS utilities.
+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.