Tag: getting-started

Getting Started with Bubbles in TypeScript: Spinners, Inputs, Lists and Tables for Terminal Apps

A from-zero guide to @oakoliver/bubbles, the TypeScript port of Charm's component library for Bubble Tea. Add a spinner, a text input, a filterable list and a table to a terminal app, then combine two components with focus switching. Every program runs on Node, Bun and Deno.

Getting Started with Bubble Tea in TypeScript: Interactive Terminal Apps in Six Small Programs

A from-zero guide to @oakoliver/bubbletea, the TypeScript port of Charm's Bubble Tea. Learn the Elm Architecture with a counter, then add key handling, timers, full-screen mode and printed output, and finish with a styled todo app. Every program runs on Node, Bun and Deno.

Getting Started with pageindex: Tree Indexes for Reasoning-Based RAG

A hands-on introduction to pageindex, the TypeScript port of PageIndex: turn a Markdown document into a tree of sections from the CLI and from code, thin the tree, add summaries through any OpenAI-compatible endpoint, and write the tree-search loop that answers questions from the right section. Offline first, with clear notes on which steps need an LLM.

Getting Started with specify-cli: Spec-Driven Development in Ten Minutes

@oakoliver/specify-cli is GitHub Spec Kit's `specify` command for Node and Bun. This guide sets up a project for an AI coding agent, walks through every file it generates, checks the setup with status and doctor, and explains the specify → plan → tasks → implement loop the generated skills give your agent.

Getting Started with Glow: Read Markdown in Your Terminal

Install one npm package and your terminal renders Markdown: files, stdin, URLs, a browsable TUI for a whole docs folder, styles, a git hook that shows the changelog after every pull, and an npm script for your project's docs. Every command here was run as written.

Getting Started with gum: Interactive Shell Scripts Without Writing a TUI

@oakoliver/gum gives bash scripts menus, prompts, confirmations, spinners, styled boxes, Markdown and tables, one command at a time. This guide builds up to a conventional-commit helper in seven steps, and every picture is the real output of the script beside it.

Getting Started with kb: A Knowledge Base an LLM Writes for You

@oakoliver/kb turns notes, papers and web pages into a linked, Obsidian-compatible wiki: you ingest sources, an LLM compiles them into articles, and you search, lint and browse the result from the terminal. This guide goes from an empty folder to KB Studio, and shows which steps need an API key.

Getting Started with bm25s: Full-Text Search in TypeScript Without a Search Server

A hands-on introduction to bm25s, the TypeScript port of Python's BM25 library: index a corpus, rank results with scores, pick a BM25 variant, tune k1 and b, add stopwords and stemming, save and load an index, and finish with a small CLI that searches your Markdown notes. Every example runs on Node, Bun and Deno.

Getting Started with Lip Gloss in TypeScript: Terminal Styling in Ten Minutes

@oakoliver/lipgloss brings Charm's Lip Gloss to Node, Bun and Deno: CSS-like styles for the terminal, with borders, padding, colors and layout. This guide goes from an empty folder to a small status dashboard in five runnable steps, each with its real output.

Getting Started with Huh in TypeScript: Terminal Forms in Ten Minutes

From npm install to a working project scaffolder: one question, a multi-field form, validation, themes, and a script that writes real files. Every snippet in this guide was run as written, on Node and Bun, and every animation is a recording of that run.

Getting Started with Glamour in TypeScript: Render Markdown in the Terminal

@oakoliver/glamour renders Markdown as styled terminal output on Node, Bun and Deno: headings, tables, task lists, syntax-highlighted code and seven built-in themes. This guide goes from one function call to a small script that renders any README in your terminal, with the real output of every step.

Getting Started with Rod in TypeScript: Drive Chrome Over the DevTools Protocol

Three small zero-dependency packages, @oakoliver/browser-launcher, @oakoliver/cdp and @oakoliver/cdp-input, let you start Chrome, send it DevTools Protocol commands and type and click like a user, from Node 22+ or Bun. This guide goes from an empty folder to a script that fills in a form, waits for the result and saves a screenshot.

Getting Started with VHS in TypeScript: Terminal GIFs Written as Code

@oakoliver/vhs is a Node and Bun port of Charm's VHS: you write a .tape file of keystrokes and pauses, and it renders a GIF, MP4 or PNG of a real terminal running them. This guide covers the prerequisites, a first tape, waiting on output, styling, rendering from TypeScript, keeping README GIFs fresh, and the tape-language gotchas we hit along the way.