npm i -g @antfu/ni

corepack enable
pnpm install

# For Rust dependencies (optional, only if working on crates/)
cargo fetch

git checkout -b <your-username>/<feature|fix>/<short-description>

# Examples:
git checkout -b alice/feat/add-weather-widget
git checkout -b bob/fix/memory-leak

# Run command in specific workspace
pnpm -F <package-name> <command>

# Examples:
pnpm -F @proj-airi/stage-web dev
pnpm -F @proj-airi/stage-tamagotchi build
pnpm -F @proj-airi/stage-ui typecheck

<script setup lang="ts">
import { ref, computed } from 'vue'

// Props
interface Props {
  title: string
  count?: number
}

const props = withDefaults(defineProps<Props>(), {
  count: 0,
})

// Emits
interface Emits {
  update: [value: number]
}

const emit = defineEmits<Emits>()

// State
const localCount = ref(props.count)

// Computed
const displayText = computed(() => `${props.title}: ${localCount.value}`)

// Methods
function increment() {
  localCount.value++
  emit('update', localCount.value)
}
</script>

<template>
  <div :class="[
    'p-4',
    'bg-white dark:bg-black',
    'rounded-lg',
  ]">
    <h2 class="text-xl font-bold mb-2">
      {{ displayText }}
    </h2>
    <button 
      :class="[
        'px-4 py-2',
        'bg-blue-500 hover:bg-blue-600',
        'text-white',
        'rounded',
      ]"
      @click="increment"
    >
      Increment
    </button>
  </div>
</template>

<style scoped>
/* Prefer UnoCSS over scoped styles */
</style>

# Lint and fix issues
pnpm lint:fix

# Type check
pnpm typecheck

# Run tests
pnpm test:run

pnpm to-avif <PATH_TO_IMAGE_OR_DIRECTORY>

# Example:
pnpm to-avif docs/images/screenshot.png

# Format
<type>(<scope>): <description>

# Examples
feat(stage-ui): add weather widget component
fix(server-runtime): resolve memory leak in peer registry
docs: update plugin development guide
refactor(stage-web): improve chat message rendering
test(stage-tamagotchi): add tests for settings store
chore: update dependencies

✨ feat(stage-ui): add weather widget component
🐛 fix(server-runtime): resolve memory leak
📝 docs: update plugin development guide

# Stage changes
git add .

# Commit with message
git commit -m "feat(stage-ui): add weather widget component"

# Push to your fork
git push origin <your-branch-name> -u

# Fetch latest changes
git fetch --all

# Switch to main branch
git checkout main

# Pull latest from upstream
git pull upstream main --rebase

# Update your fork
git push origin main

# Rebase your feature branch (optional)
git checkout <your-branch-name>
git rebase main

# Run unit tests
pnpm test:run

# Run tests with coverage
pnpm test

# Run specific test
pnpm exec vitest run path/to/test.test.ts

# Watch mode (during development)
pnpm exec vitest

# Start docs dev server
pnpm dev:docs

# Edit MDX files in docs/content/
# Create new pages as needed
# Follow Mintlify syntax