Prerequisites

Before you install SparkFeed, make sure your development environment meets these requirements.

Required Tools

Bun

SparkFeed uses Bun as its package manager and runtime (replaces Node.js + npm).

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

# Check installed version
bun --version
# Expected: 1.x.x

Windows users: install via bun.sh or use WSL2.

Already have Node.js?

Bun is a drop-in replacement, so you can keep Node.js installed. Bun handles all SparkFeed scripts; you don’t need to run anything with node directly.

Git

You’ll need Git to clone the repository.

# Check if Git is installed
git --version
# Expected: git version 2.x.x

Download Git from git-scm.com if you don’t have it.

A terminal

Any terminal works:

• macOS: Terminal, iTerm2, or Warp
• Windows: PowerShell, Windows Terminal, or WSL2 (recommended)
• Linux: Any terminal emulator

Recommended Tools

These aren’t required, but they’ll make your experience better:

Tool	Purpose
VS Code	Best editor for TypeScript/React projects
Bruno or Postman	Testing the internal API endpoints
TablePlus or DB Browser for SQLite	Inspecting the local SQLite database

System Requirements

Requirement	Minimum	Recommended
RAM	512 MB	2 GB
Disk Space	100 MB	500 MB
OS	Windows 10, macOS 11, Ubuntu 20.04	Latest versions

Note

SparkFeed is a local application. The disk space you need beyond the install depends on how many articles you fetch and cache. Most users won’t exceed a few hundred megabytes even with thousands of articles.

Next Step

Once you have Bun and Git installed, proceed to Local Setup →