Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Getting Started

Welcome to Listsome! This guide will help you set up your instance and discover DIY content from the indie web.

What is Listsome?

Listsome is a federated platform for discovering and sharing DIY content. Each instance is self-hosted and operated independently, connected to other instances through a simple subscription model.

Quick Start

Step 1: Set Up Your Instance

  1. Visit your listsome instance
  2. Complete the setup wizard to create your admin account
  3. Configure your instance details (name, domain, description)

Step 2: Add Content

  1. Go to Admin → New Project
  2. Add your tutorials, recipes, or DIY projects
  3. Use markdown for content formatting
  4. Tag content for organization

Your content is now available via RSS feed and visible to anyone who follows your instance.

Step 3: Discover Content

  1. Go to Admin → Federation
  2. Add instances to your blogroll
  3. Your instance will fetch their RSS feeds
  4. New content appears in your aggregated feed
  1. Visit the Timeline to see content from followed instances
  2. Use Search to find specific content across all feeds
  3. Filter by tags or content type

Your Instance Features

Content Publishing

  • Create and manage projects with markdown
  • Organize with tags
  • Generate RSS feeds for your content
  • Share your instance URL with others

Discovery

  • Add instances to your blogroll
  • Aggregate content from followed instances
  • Search across all aggregated content
  • Follow your interests

Federation

  • Your instance is discoverable via WebFinger
  • Others can find and subscribe to your content
  • No complex ActivityPub required - just RSS

Best Practices

Content

  • Quality over quantity - Better to have great tutorials than many mediocre ones
  • Use tags - Help others discover your content
  • Regular updates - Keep your content current

Discovery

  • Follow curated instances - Find instances that share content you care about
  • Stay organized - Review your blogroll periodically
  • Trust your sources - Only follow instances you find trustworthy

Key Concepts

Blogroll

A list of instances you follow. When you add an instance, your instance subscribes to their RSS feed.

Aggregation

Content from followed instances is fetched and stored locally, making it searchable and browsable.

Federation

Listsome instances are decentralized. Each operates independently but can discover and share content with others.

Next Steps

  1. Add Your First Project - Share your DIY content
  2. Manage Your Blogroll - Discover content from others
  3. Browse the Timeline - See aggregated content
  4. Search Content - Find specific tutorials or projects

Need Help?

Ready to start? Set up your account, add some content, and start discovering DIY projects from the indie web!