The public-facing website for Alloy, a from-scratch Minecraft modding ecosystem.
Alloy is not a fork, not a reskin, not built on top of anything that came before it. Every piece — the mod loader, modding API, mappings pipeline, modpack format, launcher, and dev tooling — is original. This site exists to announce the project, attract developers, and serve as the home base for everything Alloy.
| Layer | Choice |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS v4 |
| Fonts | Space Grotesk, Inter, JetBrains Mono |
| Hosting | Cloudflare Pages (static export) |
| Package Manager | Bun |
No heavy dependencies. The only runtime dependency beyond React and Next.js is clsx for className composition.
# Install dependencies
bun install
# Start dev server
bun run dev
# Production build (outputs to out/)
bun run buildThe dev server runs at http://localhost:3000.
src/
├── app/ # Next.js App Router pages
│ ├── page.tsx # Home — hero, pipeline, terminal demo, comparison
│ ├── about/ # Philosophy, core pillars, roadmap
│ ├── getting-started/ # Step-by-step mod creation guide
│ ├── downloads/ # Launcher, installer, template cards
│ ├── docs/ # Documentation category grid (placeholder)
│ ├── community/ # Discord, GitHub, contributing
│ └── not-found.tsx # Custom 404
├── components/
│ ├── layout/ # Header, Footer
│ ├── ui/ # Button, Card, Badge, CodeBlock, SectionHeading
│ ├── effects/ # ForgeSparks, EmberGlow, GridOverlay
│ └── icons/ # Inline SVG components (logo, icons)
└── lib/
├── cn.ts # clsx wrapper
└── constants.ts # Site metadata, nav items, external links
Full design system reference — colors, typography, components, effects — is documented in TYPOGRAPHY.md.
The short version:
- Palette: Obsidian blacks + ember orange (
#ff6b00) primary accent + forge gold highlights - Fonts: Space Grotesk for headings, Inter for body, JetBrains Mono for code
- Effects: CSS-only forge sparks, radial ember glows, animated pipeline connectors
- All animations respect
prefers-reduced-motion - All text meets WCAG AA contrast requirements
This site is configured for Cloudflare Pages static export:
- Build command:
bun run build - Output directory:
out/ - No server runtime required — pure static HTML/CSS/JS
The next.config.ts is set to output: "export" with images.unoptimized: true for Cloudflare compatibility.
Alloy is built in the open. If you want to contribute to the website:
- Fork the repo
- Create a branch
- Make your changes
- Verify the build passes (
bun run build) - Open a PR
For design changes, reference TYPOGRAPHY.md to stay consistent with the established visual identity.
MIT