AI-Powered Personal Knowledge Capture & Retrieval
Never forget what you've seen. Drop anything in — AI organizes it for you.
Features • Tech Stack • Getting Started • Roadmap • Support
We consume tons of content daily — articles, tweets, docs, screenshots — but lose 90% of it. Bookmarks pile up. Screenshots disappear. That article you read last week? Gone.
Synapse fixes this with AI. Paste a URL, upload a screenshot, or drop in a text snippet → AI reads, summarizes, extracts key points, tags, and categorizes → Find anything instantly.
- Universal Capture — URLs, images/screenshots (Gemini Vision), and text snippets
- AI Processing — Auto-summarization, key points extraction, smart tagging, content type detection (powered by Google Gemini)
- Collections — Organize captures into themed collections with emoji icons
- Pin Captures — Keep important items easily accessible
- Search — Filter captures by title, summary, URL, or tags
- User Settings — Profile management, password change, theme toggle, account deletion
- Dark & Light Mode — Clean dark-first design with yellow accent (
#ff990a) - SPA Navigation — Client-side data caching for instant page transitions
- Infinite Scrolling — Progressive content loading with IntersectionObserver
- Masonry Layout — Beautiful image grid for visual captures
- Responsive Design — Works on desktop and mobile
- Landing Page — Animated marketing page with GSAP scroll animations
- Auth — Email/password signup, login, logout with confirmation dialog
- Delete Confirmation — All destructive actions require explicit confirmation
- Semantic search with pgvector embeddings
- Smart collections (AI auto-organized)
- Paywall & subscriptions via Polar (freemium model)
- Archive system
- Browser extension
- Daily/weekly digest
- Public sharing
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS v4 |
| AI | Google Gemini (Flash, Vision) |
| Database | Neon PostgreSQL (Serverless) |
| ORM | Drizzle ORM |
| Auth | Better Auth |
| Storage | Vercel Blob |
| Animations | GSAP + ScrollTrigger |
| Hosting | Vercel |
- Node.js 20+
- pnpm
- A Neon PostgreSQL database
- A Google AI API key (Gemini)
- A Vercel Blob token
- Clone the repo
git clone https://github.com/hsnrique/synapse.git
cd synapse- Install dependencies
pnpm install- Configure environment
cp .env.example .envFill in your credentials in .env:
DATABASE_URL="your-neon-connection-string"
GEMINI_API_KEY="your-gemini-api-key"
BETTER_AUTH_SECRET="generate-a-random-secret"
BETTER_AUTH_URL="http://localhost:3000"
NEXT_PUBLIC_APP_URL="http://localhost:3000"
BLOB_READ_WRITE_TOKEN="your-vercel-blob-token"- Push database schema
npx drizzle-kit push- Run the dev server
pnpm devOpen http://localhost:3000 and create your account.
synapse/
├── app/
│ ├── api/ # API routes (captures, collections, tags, profile, search)
│ ├── dashboard/ # Dashboard pages (captures, collections, settings, detail)
│ ├── login/ # Login page
│ ├── signup/ # Signup page
│ └── page.tsx # Landing page
├── components/
│ ├── dashboard/ # Dashboard components (sidebar, cards, modals, provider)
│ ├── landing/ # Landing page sections (hero, features, CTA)
│ └── ui/ # Reusable UI components (confirm dialog)
├── db/
│ ├── schema.ts # Drizzle ORM schema
│ └── index.ts # Database connection
├── lib/
│ ├── ai.ts # Gemini AI processing pipeline
│ ├── auth.ts # Better Auth config
│ └── session.ts # Session helper
└── hooks/ # Custom React hooks (infinite scroll)
- Universal capture (URL, image, text)
- AI processing pipeline (Gemini)
- Collections CRUD
- Tags (auto-generated + management)
- Pin captures
- User profile & settings
- Dark/light mode
- SPA navigation with client-side caching
- Infinite scrolling
- Responsive design
- Delete confirmation dialogs
- Semantic search (pgvector)
- Polar paywall integration
- Smart collections
- Archive system
- Browser extension
If you find Synapse useful, consider supporting the project:
| Link | |
|---|---|
| ☕ Buy Me a Coffee (US/EU) | buymeacoffee.com/hsnrique |
| 💜 Pix (BR) | livepix.gg/hsnrique |
MIT — see LICENSE for details.
Synapse is open source software. You are free to self-host, modify, and contribute.