Random Place · Street View Atlas

Frontend-only React app that drops you into random Google Street View locations inside any city, country, or address. Includes a mini-map for orientation and a bold, editorial UI.

Setup

1. Install dependencies:

bun install

2. Create an .env file (see .env.example) and add your Google Maps API key:

VITE_GOOGLE_MAPS_API_KEY=your_key_here

Make sure the key has the Maps JavaScript API, Geocoding API, and Places API enabled.

3. Run the dev server:

bun run dev

Scripts

• bun run dev — start Vite
• bun run build — production build
• bun run preview — preview build locally

Data sources

• City list derived from GeoNames cities15000 and countryInfo dumps (CC BY 4.0).