Skip to content

artlu99/snappa-mini-app

Repository files navigation

Snappa Mini App

a state-of-the-artlu Jun 2025 Farcaster Mini App

Singe Page Application (SPA) using Preact, TypeScript, TailwindCss v4 and Vite, designed to run forever on scale-to-zero Cloudflare Workers and other services that scale without provisioning.

bleeding edge Mini App features

  • Share Actions load specific casts from the feed into a Mini App
  • ThirdWeb Auth for Farcaster + web2 social + passkeys

The DX features hot module replacement, fast Rust-based Biome linting, and zero-config services. It uses only the API of the Neynar Free Plan.

πŸš€ Supercharged web development with this BHVR-adjacent stack:

  • Preact - Fast 3kB alternative to React
  • Vite - Lightning-fast build tooling and development server
  • Hono - Ultralight, modern backend framework
  • Cloudflare Workers - Edge computing platform for global deployment
  • Neynar - Easiest way to build on Farcaster
  • Momento Cache - Robust, turnkey caching with ultra low-latency and instance-free adaptive scalability

✨ Key Features

  • 🎯 a modern and stable DX on Tailwind, JSX, Frames SDK
  • πŸ› οΈ Rust-based Biome formatting and linting
  • ⚑ Hot Module Replacement (HMR) for rapid development
  • πŸ“¦ end-to-end type safety with no-codegen autocomplete
  • πŸ”₯ API routes with Hono's elegant routing
  • πŸ”„ Zero-config deployment to Cloudflare

Development

Install dependencies:

bun install

Update variables in wrangler.jsonc and .dev.vars:

vi wrangler.jsonc
bun run types

Start the development server with:

bun dev

Your application will be available at http://localhost:5173.

Production

Build your project for production:

bun build

Deploy your project to Cloudflare Workers:

bun run deploy

Update secrets in prod, e.g.:

wrangler secret put JWT_SECRET
wrangler secret put MOMENTO_API_KEY
wrangler secret put NEYNAR_API_KEY
wrangler secret put SECRET

or via Cloudflare Workers dashboard (copy and paste contents of .dev.vars)

auth

JWT_SECRET

SECRET

bookmarks

DECENT_BOOKMARKS_SECRET

caching

MOMENTO_API_KEY

defi

COINGECKO_API_KEY

ETHERSCAN_API_KEY

ZEROEX_API_KEY

neynar

NEYNAR_API_KEY

thirdweb

ADMIN_PRIVATE_KEY

THIRDWEB_SECRET_KEY

sassyhash

YOGA_WHISTLES_BEARER

YOGA_WHISTLES_WRITE_TOKEN

About

🐟 Snappa, SassyHash πŸ’…, πŸ”– Decent Bookmarks, 🦍 Snappa Swappa

Topics

Resources

License

Stars

Watchers

Forks

Languages