Skip to content

Timeline Theme

The @indiepub/theme-timeline package (at themes/timeline in the monorepo) is an IndiePub site built around a social-media-style feed. Notes, photos, articles, bookmarks, and all other post types appear as cards in a chronological stream, with a persistent sidebar showing your profile and tag navigation.

How it differs from the other themes

DefaultBylineTimeline
AudienceDevelopers, IndieWeb enthusiastsWriters and bloggersMicro-bloggers, social stream
LayoutTwo-column, sidebar rightSingle-column editorSidebar left, feed right
Writing experienceAdmin panelIn-theme /write dashboardAdmin panel
Feed styleArticle-forwardArticle-forwardCard-based, all post types equal

Feed layout

The homepage (/) loads up to 50 entries across all post types and renders them as FeedCard components. Each card adapts its layout to the post type:

  • Notes — text content with optional photo carousel and syndication links
  • Articles — title + summary excerpt with a “read more” link
  • Photos — photo carousel with caption
  • Bookmarks — source URL with optional description
  • Verb entries (watch/read/listen/play) — object name, rating, and activity icon
  • Replies/likes/reposts — interaction context with the referenced URL

Post type badges appear on all non-note entries so the reader always knows what they’re looking at.

The left sidebar shows:

  • Author avatar, name, and bio
  • Site navigation links (Home, Articles, Notes, Photos, Bookmarks)
  • Top tags (up to 20), linked to /tags/[slug]

On mobile the sidebar collapses behind a hamburger menu. The mobile header shows the site title and a toggle button.

Getting started

Terminal window
cd themes/timeline
pnpm install
pnpm db:migrate # applies migrations to local D1
pnpm dev

Visit http://localhost:4321/admin/onboarding to finish setup.

Dependencies

The timeline theme uses the standard IndiePub stack with no additional UI dependencies beyond astro-icon.