🚀 Getting Started

Panduan lengkap untuk memulai perjalananmu dengan BlizzardTS.

Prasyarat

Sebelum mulai, pastikan kamu sudah menginstall Bun (v1.0 atau lebih baru).

# Install Bun (Mac/Linux/WSL)
curl -fsSL https://bun.sh/install | bash

# Install Bun (Windows PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

Instalasi

Menggunakan Starter Template (Recommended)

Cara tercepat untuk memulai adalah menggunakan starter template resmi yang sudah dilengkapi dengan TailwindCSS dan konfigurasi siap pakai.

# Clone starter template
bun create blizzard-app my-app
cd my-app

# Install dependencies
bun install

# Jalankan server development
bun run dev

Buka http://localhost:3000 di browser kamu. Project ini sudah termasuk:

TailwindCSS & Shadcn setup.
Layout System example.
Hot Reloading.

Instalasi Manual

Jika kamu lebih suka setup sendiri dari nol:

Buat folder baru:
```
mkdir my-app && cd my-app
bun init
```
Install BlizzardTS:
```
bun add blizzardts
```

Hello World

Mari kita buat server HTTP sederhana. Buat file src/index.ts:

src/index.ts

import { Blizzard } from "blizzardts";
import { handle } from "blizzardts/adapter/bun";

const app = Blizzard();

// Route sederhana
app.get("/", (c) => {
  return c.text("Hello Blizzard! ❄️");
});

// JSON Response
app.get("/api", (c) => {
  return c.json({
    message: "Welcome to the future!",
    timestamp: Date.now()
  });
});

export default handle(app);

Menjalankan Server

Jalankan server dalam mode development (dengan hot reload):

bun run --watch src/index.ts

Buka browser dan akses http://localhost:3000. Selamat! Kamu baru saja men-deploy server BlizzardTS pertamamu. 🎉

Struktur Project yang Disarankan

Untuk aplikasi skala besar, kami menyarankan struktur berikut:

my-app/
├── src/
│   ├── index.ts        # Entry point aplikasi
│   ├── routes/         # Definisi route dan handler
│   ├── middlewares/    # Custom middleware
│   ├── services/       # Business logic layer
---
title: Getting Started
description: Mulai project BlizzardTS pertamamu dalam hitungan detik. 🚀
icon: Rocket
---

import { Steps } from 'fumadocs-ui/components/steps';
import { Callout } from 'fumadocs-ui/components/callout';

# 🚀 Getting Started

Panduan lengkap untuk memulai perjalananmu dengan BlizzardTS.

## Prasyarat

Sebelum mulai, pastikan kamu sudah menginstall **Bun** (v1.0 atau lebih baru).

```bash
# Install Bun (Mac/Linux/WSL)
curl -fsSL https://bun.sh/install | bash

# Install Bun (Windows PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"