Bannquet
Mountain weather and trip reports for the Northeast. Bannquet pulls National Weather Service forecasts for summits and valleys across the Adirondacks, Catskills, Shawangunks, Green Mountains, White Mountains and Maine, and keeps published trip reports for the crew.
Live at bannquet.com.
What it does
- Hourly and daily forecasts, wind, precipitation and alerts for each mountain. Regions live in
config/weather-regions.json, so adding a spot is a data change.
- A ticker at the top of the homepage showing the current extremes across those regions.
/peaks lists the Catskill 35, Adirondack 46, New Hampshire 48, Vermont 4000-footers, Maine 4000-footers, and the New England 67 as those three New England lists together. A summit counts only when someone logs “I climbed this.” The lists live in config/challenges. A finished list shows a small 88×31 badge on the stats page and on that person's profile. /stats keeps the miles, elevation, and summit leaderboards for on foot, bike, and ski./community links to posts, peaks, stats, trips, and the map. Posts, peaks, stats, and trips share a small sub-nav./trips is a light planner: a title, a date, notes, an I'm-in toggle, attached pins, routes and photos, and a shared packing list. Templates for day hike, overnight, winter, bike, and ski live in config/packing-templates.json..- Published trip reports read from Postgres. Signed-in friends write a post (title, date, activity, tagged friends, story, photos, optional GPX) and it shows in the feed and on the map.
- The home page banner links to
/conditions, which lists the same National Weather Service extremes and the spots behind them.
- The map uses MapLibre. Standard tiles are OpenFreeMap. Topo and satellite are USGS National Map. Hybrid keeps OpenFreeMap labels on the imagery. 3D terrain uses AWS Terrarium elevation tiles. None of these are paid map APIs.
More detail on the weather endpoints is in API_DOCUMENTATION.md.
Stack
Next.js 16.3, React 19.2, TypeScript, Tailwind CSS 4, Framer Motion, Drizzle ORM, and Neon Postgres. Weather comes from the NWS API. Deployed on Vercel.
Running it locally
You need Node.js 20 or newer.
npm install
npm run dev
Then open http://localhost:3000. Copy .env.example to .env.local.
Weather pages work with no keys. Mountain fishing reads USGS water data without a key, on a low rate limit. Set USGS_WATER_DATA_API_KEY (or WATER_DATA_API_KEY) on Vercel for the higher limit. Trip reports stay empty until DATABASE_URL points at a Postgres database and the schema has been migrated. Reading the site stays public. Anyone can make an account at /sign-up. Until Jake approves them on /admin, they can sign in and read, but they cannot post or edit. An invite link from /admin still skips that wait. After that they sign in with email and password. ADMIN_EMAIL is the address that can sign in without an invite and is stored as admin. Sessions last a week and refresh when someone comes back, which is as long as Neon Auth keeps them. Photo uploads need BLOB_READ_WRITE_TOKEN from the Vercel Blob store.
Database
DATABASE_URL is the pooled Neon connection (the host contains -pooler). DATABASE_URL_UNPOOLED is the direct connection Drizzle uses for migrations.
npm run db:generate # write a new SQL migration from src/db/schema.ts
npm run db:migrate # apply drizzle/ to DATABASE_URL_UNPOOLED
Run migrations against a Neon branch before production. The first migration enables PostGIS.
Old /trip-reports/<id> links redirect to /posts/<id>. The public feed is /posts. Profile pages live at /user/<username>; /hikers/<username> redirects there.
Scripts
npm run dev starts the dev servernpm run build builds for productionnpm run start serves the production buildnpm run lint runs ESLintnpm run typecheck runs TypeScriptnpm test runs the small node tests
The live-conditions socket server for the user map is a separate project, bannquet-io.
