Run the Project

With setup complete, you’re ready to start SparkFeed.

Start the Development Server

Run the following command from the project root:

bun run dev

You should see Vite and TanStack Start start up, then navigate to:

Open your browser and navigate to:

http://localhost:3000

First-Time Setup in the UI

When you open SparkFeed for the first time, you’ll see an empty feed list. Here’s how to get started:

1. Add your first feed

Click “Add Feed” in the sidebar and enter the URL of any RSS or Atom feed.

Some great feeds to start with:

https://hnrss.org/frontpage           # Hacker News Front Page
https://feeds.feedburner.com/oreilly  # O'Reilly Radar
https://css-tricks.com/feed/          # CSS-Tricks
https://blog.samaltman.com/feed       # Sam Altman's Blog
https://overreacted.io/rss.xml        # Dan Abramov's Blog

2. Wait for the first fetch

SparkFeed will fetch the feed and populate it with articles. This usually takes 1–3 seconds per feed.

3. Read an article

Click any article title to open it in the reading view. The full article content (if the feed provides it) or a summary with a link to the original is shown.

Available Commands

Command	Description
`bun run dev`	Start development server with hot reload
`bun run build`	Build production bundle
`bun run preview`	Preview the production build locally
`bun run db:push`	Push Drizzle schema to the database
`bun run db:studio`	Open Drizzle Studio (database GUI)
`bun run typecheck`	Run TypeScript type checking
`bun run lint`	Run ESLint across the codebase

Drizzle Studio

You can explore your database visually using Drizzle Studio:

bun run db:studio

This opens a web-based GUI at http://localhost:4983 where you can browse your feeds, articles, and favorites tables.

Next Step

Now that SparkFeed is running, learn how to Build & Deploy → it as a production-ready application, or dive into the Core Concepts → to understand how everything works.