Twilic Website

Source for the Twilic documentation website, built with VitePress.

Requirements

• Node.js 24+
• Bun 1.4.2

Setup

bun install

Development

bun run dev

Opens a local dev server at http://localhost:5173 with hot reload.

Build

bun run build

Outputs to docs/.vitepress/dist/.

Preview

bun run preview

Serves the production build locally for final review before deploy.

Formatting and lint

bun run format          # format all .md, .ts, .css, .json files
bun run format:check    # check formatting without writing (used in CI)
bun run lint            # markdownlint on docs/**/*.md

Project layout

website/
  docs/
    .vitepress/
      config.ts          # VitePress config (nav, sidebar, Mermaid)
      theme/
        index.ts          # theme entry (slots, global components)
        custom.css        # brand colors, CSS variable overrides
        HomeFeatures.vue  # home page feature cards (Tabler icons)
        HeroCode.vue      # hero code preview card
    guide/
      introduction.md
      why.md
      quick-start.md
      concepts.md
      cookbook.md
      comparison.md
      faq.md
    spec/
      overview.md
      profiles.md
      wire-tags.md
      format.md
      encoding.md
      transport.md
      v2.md
      v1.md
    sdks/
      index.md
      rust.md
      go.md
      python.md
      js.md
      java.md
      ruby.md
      zig.md
      php.md
      kotlin.md
      dart.md
      elixir.md
      cpp.md
      csharp.md
      swift.md
    benchmark.md
    public/
      apple-touch-icon.png
      favicon-32.png
      favicon.svg
      logo.svg
      mark.svg
      og.png
  .github/
    ISSUE_TEMPLATE/      # bug report, feature request
    workflows/           # CI, commitlint, PR checks, invisible-chars
    pull_request_template.md
    dependabot.yml

Contributing

See CONTRIBUTING.md for general contribution guidelines.

For website-specific changes:

1. Run bun run dev and verify the affected pages look correct.
2. Run bun run format:check and bun run lint before opening a PR.
3. Use the PR template — all required sections and checklist items must be filled.

License

Content is released under CC-BY-4.0.