---
layout: home

hero:
  name: BitLogger
  text: Structured logging for MoonBit
  tagline: Start with a runnable logging flow, then extend it with precise API reference.
  actions:
    - theme: brand
      text: Start Examples
      link: /examples/
    - theme: alt
      text: Extend A Logger
      link: /extend/
    - theme: alt
      text: Mooncake Package
      link: https://mooncakes.io/docs/Nanaloveyuki/BitLogger

features:
  - title: Examples first
    details: Follow complete console, file, config, and async flows before looking up individual symbols.
  - title: Extend deliberately
    details: Add queues, custom sink graphs, formatting, and target-specific behavior only when the base flow needs them.
  - title: API as reference
    details: Use the one-symbol-per-page API reference for exact signatures, contracts, and edge cases.
---

## Start Here

1. Read [Examples](./examples/index.md) for an end-to-end path from installation to a running logger.
2. Read [Extend](./extend/index.md) when the base console flow needs queueing, custom routing, formatting, files, or target-aware behavior.
3. Use [API Reference](./api/index.md) for exact contracts and [Release Notes](./changes/index.md) for version history.