Drafts for Bluesky.social 🦋
Busqued is a tiny, fast web app for writing and saving Bluesky post drafts before you publish them. It looks and feels like the Bluesky app — centered feed, post cards, a compose box with a live character ring — and lets you post a draft straight to your account over the AT Protocol when you're ready.
🔗 Live: https://davecaos.github.io/busqued/
- 📝 Draft management — create, edit, and delete drafts; everything is saved locally in
localStorage(no backend, no account needed to start). - 🦋 Bluesky-style UI — circular avatar, display name ·
@handle· timestamp, and edge-to-edge post cards in a centered feed. - ✍️ Composer with a live character ring — a Bluesky-style circle that counts down the remaining characters (300 → 0) as you type.
- 🚀 Post to Bluesky — sign in with your handle + an app password and publish a draft over the AT Protocol (
@atproto/api). Your session is persisted and restored on reload. - 👤 Real profile — once logged in, your actual avatar and display name appear on the cards and in the composer.
- 🌗 Light / dark mode — a sun/moon toggle with a Bluesky-accurate dark theme.
- 📱 Responsive — full-width edge-to-edge on phones and tablets, centered column on desktop.
- React 18 + TypeScript
- Vite 6 (build & dev server)
- Chakra UI v3 + next-themes for theming
- @atproto/api for Bluesky auth & posting (lazy-loaded)
- react-icons (Lucide set)
npm i
npm run dev # start the dev server
npm run dev -- --host # also expose it on your local networkThen open the printed URL (e.g. http://localhost:5173/busqued/).
| Command | What it does |
|---|---|
npm run dev |
Start the Vite dev server with HMR |
npm run build |
Type-check (tsc -b) and build to dist/ |
npm run preview |
Serve the production build locally |
npm run lint |
Run ESLint |
npm run format |
Format src/ with Prettier |
npm run deploy |
Build and publish dist/ to GitHub Pages |
- All drafts live in
localStorageunderbusqued.v0.1; the Bluesky session is stored underbusqued.bsky.session.v1. - Login uses Bluesky app passwords via
BskyAgent— your main account password is never used. - The app is a single-page client deployed to GitHub Pages under the
/busqued/base path; there is no server.
Personal project — use at your own risk.