A quiet home for poetry, short stories, essays and the small lines in between.
Most of the internet is built for scrolling. Simplicity is built for reading.
It is a community where people publish short-form literature (a haiku, a ghazal, a piece of flash fiction, a letter they never sent) and where every piece is set the way it deserves to be read. Verse is centred with its line breaks intact. Stories and essays get a calm, book-like column. A single line becomes a pull quote. There are no ads, no algorithmic outrage and no clutter: just words, the people who write them, and the readers who keep them.
Four kinds of writing, each with forms that shape how a piece is presented and discovered.
| Type | Forms |
|---|---|
| Poetry | Free verse, haiku, sonnet, ghazal, shayari, limerick, prose poem, rhymed verse |
| Stories | Short story, flash fiction, fable |
| Essays | Personal essay, reflection, letter, journal |
| Micro | Quote, six-word story, one-liner |
- A distraction-free editor that understands poetry: Enter starts a new line, and Enter on an empty line starts a new stanza.
- Drafts save themselves as you type. Preview the piece exactly as readers will see it before you publish.
- Tags, subtitles and section breaks, with formatting kept deliberately minimal.
- Layouts per type: centred verse, a prose column with drop caps, and display-type cards for micro-writing.
- Reading settings for text size, serif or sans, and line spacing, remembered across visits.
- A reading progress bar, estimated reading time, and "more from this author" at the end of each piece.
- Paper-toned light theme and an ink dark theme with a faint, animated night sky.
- Feeds: For you, Latest, Trending, Most loved and Following.
- For you ranks writing by the authors you follow, the tags you love and the forms you return to, weighted by freshness.
- Explore by type, form or tag, with full-text search across titles, lines and writers.
- ⌘K quick search from anywhere.
- Author profiles at
/@usernamewith followers, loved writings and public collections. - Threaded responses on every piece.
- A personal library of bookmarks, drafts and curated, shareable collections.
- A generated share image for every writing, ready for social media or download.
- Private reporting and clear community guidelines.
Simplicity is a server-first Next.js app. Pages render on the server, mutations run as Server Actions, and the client ships only what needs to be interactive.
| Layer | Choice |
|---|---|
| Framework | Next.js 16 (App Router, Server Components, Server Actions), React 19 |
| Database | PostgreSQL on Neon, queried with Drizzle ORM |
| Search | Postgres full-text search (tsvector with weighted title, subtitle and body, GIN index) |
| Auth | Better Auth: email and password, GitHub, Google; data lives in your own database |
| Editor | Tiptap, with server-side HTML sanitisation on every save |
| UI | Tailwind CSS 4, Radix UI primitives, Fraunces, Newsreader and Inter |
| Share images | next/og, generated on demand for every writing |
Design decisions worth knowing:
- Every write is authorised on the server. Each action checks the session and ownership before touching data.
- Content is sanitised once, on write. The editor's HTML passes through an allow-list before it is stored, so rendering stays fast and safe.
- Counts are computed, not cached. Likes and comments come from indexed subqueries, so they can never drift out of sync.
- No vendor lock-in. Any Postgres works, and authentication data sits in the same database as everything else.
simplicity/
├── app/ Routes: reader, studio, explore, profiles, library, collections
├── components/
│ ├── ui/ Accessible primitives (Radix + Tailwind)
│ ├── site/ Header, footer, theme, search palette
│ ├── writing/ Cards, feeds, reader, comments, sharing
│ └── editor/ Tiptap editor and writing studio
├── lib/
│ ├── db/ Drizzle schema and client
│ ├── queries/ Server-side reads
│ ├── actions/ Server Actions (all mutations)
│ └── writing-types.ts The taxonomy of types and forms
└── drizzle/ SQL migrations
You need Node.js 20+ and a Postgres database. A free Neon project works well.
git clone https://github.com/akadeepesh/Simplicity.git
cd Simplicity/simplicity
npm install
cp .env.example .env.localFill in .env.local:
| Variable | Required | Notes |
|---|---|---|
DATABASE_URL |
Yes | Postgres connection string |
BETTER_AUTH_SECRET |
Yes | Any long random string |
BETTER_AUTH_URL, NEXT_PUBLIC_APP_URL |
Yes | http://localhost:3000 locally |
GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET |
No | Callback: <url>/api/auth/callback/github |
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET |
No | Callback: <url>/api/auth/callback/google |
Social sign-in buttons appear only when their keys are set. Email sign-up always works.
npm run db:migrate # create tables
npm run dev # http://localhost:3000| Script | Purpose |
|---|---|
npm run dev |
Development server |
npm run build |
Production build |
npm run lint |
ESLint |
npm run typecheck |
TypeScript |
npm run db:generate |
Create a migration after changing the schema |
npm run db:migrate |
Apply migrations |
npm run db:studio |
Browse data in Drizzle Studio |
The app deploys to Vercel as-is. Set the project's root directory to simplicity, add the environment variables above, and run npm run db:migrate against your production database once.
Issues and pull requests are welcome. For anything larger than a small fix, please open an issue first to talk through the idea. Run npm run lint and npm run typecheck before submitting.
MIT. See LICENSE.
Built by Deepesh Kumar · more work at akadeepesh.com