Welcome to folksbase
folksbase is a minimalist contact management system built for performance. Upload CSVs, manage contacts and tags, and get a clear picture of your data through a polished dashboard — all backed by a clean API.Live Demo
Try folksbase in action — no signup required.
Who is folksbase for?
folksbase is designed for:- Small teams and solo founders who need a lightweight way to manage contacts without the overhead of a full CRM
- Developers looking for a well-structured open-source project to learn from or extend
- Anyone importing CSV data who wants AI-assisted column mapping and a smooth import experience
Key Features
CSV Import with AI Mapping
Upload CSV files and let Claude Haiku automatically map columns to contact fields. Review suggestions, adjust if needed, and import thousands of contacts in seconds.
Contact Management
Create, search, filter, and tag contacts. Full CRUD operations with cursor-based pagination for fast performance at any scale.
Tag System
Organize contacts with tags. Filter by multiple tags at once and export filtered subsets as CSV.
Dashboard
See stats at a glance — total contacts, growth over time, recent imports and exports, all on one page.
Clean REST API
Auto-generated OpenAPI spec with interactive Scalar docs. Every endpoint is documented, validated with Zod, and rate-limited.
Background Jobs
Large imports and exports run asynchronously via Inngest with step-level retries. No timeouts, no memory issues.
Tech Stack at a Glance
| Layer | Technology |
|---|---|
| Frontend | Next.js 15 (App Router, React Server Components) |
| Styling | Tailwind CSS + Radix Primitives |
| Backend | Hono v4 |
| Database | Neon (Postgres serverless) via Drizzle ORM |
| Auth | Supabase Auth |
| Background Jobs | Inngest |
| AI | Anthropic Claude Haiku (CSV column mapping) |
| Testing | Vitest (unit) + Playwright (E2E) |