Skip to content

JordanTranchina/stash

 
 

Repository files navigation

Stash

A simple, self-hosted read-it-later app. Save articles, highlights, and Kindle notes to your own database.

Your data. Your server. No subscription.

Features

  • Chrome Extension - Save pages and highlights with one click
  • Web App - Access your saves from any device
  • Kindle Sync - Import highlights from your Kindle library
  • Full-Text Search - Find anything you've saved
  • Text-to-Speech - Basic audio generation (Edge TTS)
  • AI Podcast - Turn articles into a conversational podcast (Planned)
  • iOS Shortcut - Save from Safari on iPhone/iPad
  • Bookmarklet - Works in any browser

Why Stash?

  • Free forever - Runs on Supabase free tier (500MB, unlimited API calls)
  • You own your data - Everything stored in your own database
  • No account needed - Single-user mode, no sign-up friction
  • Works offline - PWA support for mobile
  • Open source - Fork it, modify it, make it yours

Quick Start

  1. Create a Supabase project (free) at supabase.com
  2. Run the schema from supabase/schema.sql
  3. Add your credentials to extension/config.js and web/config.js
  4. Load the extension in Chrome (chrome://extensions > Load unpacked)
  5. Deploy the web app to Vercel/Netlify (free)

See SETUP.md for detailed instructions.

Project Structure

stash/
├── extension/       # Chrome extension
├── web/            # Web app (PWA)
├── tts/            # Text-to-speech generator
├── bookmarklet/    # Universal save bookmarklet
├── ios-shortcut/   # iOS Shortcut for Safari
└── supabase/       # Database schema & Edge Functions

Tech Stack

  • Frontend: Vanilla JS, HTML, CSS (no framework bloat)
  • Backend: Supabase (PostgreSQL + REST API)
  • Hosting: Any static host (Vercel, Netlify, GitHub Pages)

Roadmap

Listen Later (AI Podcast) is currently in development. This feature will evolve the basic TTS functionality into a full-blown conversational podcast generator using LLMs. See Product Spec.md for details.

Screenshots

Coming soon

License

MIT

About

the best read-later app

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 53.4%
  • HTML 15.2%
  • Python 12.7%
  • CSS 10.6%
  • TypeScript 6.2%
  • PLpgSQL 1.9%