have you ever clicked on a website just to be bombarded with cookie modals, newsletter beggers, and ads everywhere? this is fine if you're on piratebay, but if you're seeking productivity — you need a no-distractions experience to get it done.
phived is a dead-simple, anti-procrastination to-do list. arrange tagged task lists on a canvas and add rows as you need them. no login, no cookies, no images and no ads.
just you and your next few steps.
See CONTEXT.md for canonical surface names and
docs/adr/ for deployment and routing decisions.
apps/web— Astro public web app served atphived.com/apps/app— Vite, React, and TypeScript task app served atphived.com/appapps/macos-app— native SwiftUI macOS apppackages/tokens— shared design tokens consumed by the web and app surfaces
you need these:
then, you can:
- clone this repo if you just want to look around
- fork this repo if you want to open pull requests
now, access the repo:
cd phived
finally, install dependencies from the repository root:
bun install
run a dev server:
bun run dev— runs both apps at oncebun run dev:app— only the task app (Vite)bun run dev:web— only the public web app (Astro)
to see the production-shaped combined site (/ + /app on one origin), use
bun run preview below.
Build the deployable site and native app:
bun run build
Build only the deployable web site (phived.com/ + phived.com/app):
bun run build:site
Preview the built site locally:
bun run preview
Build and open the native app:
bun run dev:macos
The packaged app is written to apps/macos-app/dist/Phived.app.
Run checks:
bun run checkbun run lintbun run typecheckbun run test:appbun run test:macos
With a full Xcode installation selected, run the XCTest suite with:
bun run test:macos:xctest
See docs/macos-parity.md for the native parity
contract and verification workflow.
issues and pull requests are appreciated