Homepage

A personal browser homepage for fast bookmark access across browsers with instant search.

Use

• Set your browser homepage as https://homepage.hsichen.dev.
• Press Space to start searching, and Enter to open.
• Sign in to upload a wallpaper; guests keep the default mountain scene.
• Click the location control to sync the nearest Taiwan weather and AQI station.

Privacy

Core features work without an account. Location is requested only after clicking the location control. The selected Taiwan location is stored in a same-site cookie for SSR and mirrored in browser storage with weather/AQI caches. Wallpaper sync requires sign-in and uses Clerk, Neon, and Vercel Blob.

Development

Quick Start

Requires Node.js 22+ and Bun.

git clone https://github.com/Hsiii/homepage.git
cd homepage
bun i
bun dev

Stack Map

• Runtime: Bun, Next.js 16 App Router, React 19, TypeScript, Turbopack in dev, Node.js standalone server in production.
• SSR: Hydrates location, weather, AQI, Clerk state, and signed-in wallpaper.
• Auth: Clerk auth
• Storage: Neon wallpaper metadata, Vercel Blob image storage.
• External data: OpenWeatherMap or Open-Meteo for weather; Taiwan MOENV for AQI.

Oracle Deployment

Production runs on the Oracle VM behind Caddy. The app is built with Next.js standalone output locally, uploaded over SSH, and served by the Oracle Compose service from /home/ubuntu/bots/artifacts/homepage.

Deploy from a clean local checkout:

bun run deploy:oracle

The container listens on 0.0.0.0:3102 and exposes /api/health for health checks.