Hoodi

A neighborhood discovery app to help you evaluate where to live next. See what's within walking distance of any address—groceries, coffee shops, parks, schools, and more—with walking times and ratings.

Features

• Interactive map showing amenities around any address
• Walking time calculations for all locations
• Google Places ratings and reviews integration
• Multiple amenity categories (groceries, coffee, parks, schools, etc.)
• Adjustable walking time radius (5, 10, 15 minutes)

Setup

1. Clone the repository

2. Install dependencies

npm install
# or
pnpm install

3. Set up environment variables

cp .env.example .env

Edit .env and add your Google Maps API key. You'll need to enable:

• Maps JavaScript API
• Places API
• Geocoding API
• Distance Matrix API (Note: This API can be costly with high usage)

4. Run the development server

npm run dev
# or
pnpm dev

Open http://localhost:3000 to start exploring.

Tech Stack

• Next.js 15 - React framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• Google Maps API - Maps and location data
• React Query - Data fetching

Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run linting
• npm run typecheck - Type checking

License

MIT