Fastladder 互換のパーソナルフィードリーダー。複数ユーザー対応のセルフホスト型アプリケーション。

• 3 ペイン UI（フィード一覧 / エントリ一覧 / エントリ本文）
• Fastladder 互換キーボードショートカット（j/k/s/a/v/p/o/r/Shift+A）
• OPML インポート・エクスポート
• 定期フィードクロール（RSS 2.0 / Atom / RDF 対応）
• エントリの既読管理・ピン留め
• モバイル対応・ダークモード対応
• パスワードレス認証（マジックリンク）

• Ruby 4.0+
• SQLite3

git clone https://github.com/ryu/tsubame.git
cd tsubame
bin/setup

初回ユーザーを作成:

TSUBAME_EMAIL=you@example.com bin/rails db:seed

開発サーバーを起動:

bin/dev

http://localhost:3000 にアクセスし、メールアドレスを入力するとログインリンクが届きます。

Resend を使用します。API キーを取得後、credentials に設定してください:

VISUAL="nvim" bin/rails credentials:edit

resend:
  api_key: re_xxxxxxxxxx

bin/dev          # 開発サーバー起動
bin/ci           # CI (rubocop, security audit, テスト)
bin/rails test   # テストのみ
bin/rubocop      # Lint のみ

Kamal 2 を使った Docker デプロイに対応。詳細は docs/deployment.md を参照。

kamal deploy

• Ruby 4.0.5 / Rails 8.1 / SQLite3
• Hotwire (Turbo + Stimulus) + Vanilla CSS
• Solid Queue (バックグラウンドジョブ)
• Kamal 2 (デプロイ)

• docs/architecture.md — アーキテクチャ概要
• docs/data_model.md — データモデル定義
• docs/keyboard_shortcuts.md — キーボードショートカット一覧
• docs/feed_crawling.md — フィードクロール設計
• docs/magic_link_auth.md — マジックリンク認証の設計
• docs/deployment.md — デプロイ手順
• docs/backup.md — バックアップ手順

MIT License