Add tests for city bikes and geo integration

.github/workflows/test.yml

@@ -0,0 +1,61 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, update-brand-assets]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.15.1
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test:run
+
+      - name: Run linter
+        run: pnpm lint
+
+  build:
+    name: Build Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.15.1
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build project
+        run: pnpm build

README.md

@@ -1,36 +1,154 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# Chattanooga Bike Map
+
+An interactive map showcasing bike routes, bike share stations, attractions, and bike resources in Chattanooga, TN. Built with love by [iFixit](https://www.ifixit.com) for the Chattanooga cycling community.
+
+![Chattanooga Bike Map](public/og-image.png)
+
+## Features
+
+- **Curated Bike Routes**: Explore popular routes including the Riverwalk Loop, Zoo Loop, and local greenways
+- **Real-time Bike Share Data**: Live availability for Chattanooga's bike share stations via GBFS API
+- **Points of Interest**: Discover attractions, bike shops, and local resources
+- **Mobile-First Design**: Optimized for on-the-go route planning with PWA support
+- **Interactive Map**: Powered by Mapbox with custom styling and route visualization
+
+## Data Sources
+
+- **Bike Share Stations**: [Chattanooga Bike Share GBFS API](https://chattanooga.publicbikesystem.net/customer/ube/gbfs/v1/)
+- **Mapping**: [Mapbox GL JS](https://www.mapbox.com/mapbox-gljs)
+- **Bike Routes**: Custom curated routes from local cycling community
 
 ## Getting Started
 
-First, run the development server:
+### Prerequisites
+
+- Node.js 20+
+- pnpm 10+ (recommended) or npm
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/kwiens/bikemap.git
+cd bikemap
+```
+
+2. Install dependencies:
+```bash
+pnpm install
+```
+
+3. Set up environment variables (MapBox secret key):
+```bash
+cp .env.example .env.local
+# Add your Mapbox token if using a custom one
+```
 
+4. Run the development server:
 ```bash
-npm run dev
-# or
-yarn dev
-# or
 pnpm dev
-# or
-bun dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+5. Open [http://localhost:3000](http://localhost:3000) to view the map
+
+### Development Scripts
+
+- `pnpm dev` - Start development server
+- `pnpm build` - Build for production
+- `pnpm start` - Start production server
+- `pnpm test` - Run tests in watch mode
+- `pnpm test:run` - Run tests once
+- `pnpm lint` - Check code quality
+- `pnpm lint:fix` - Auto-fix linting issues
+
+## Running Tests
+
+The project includes comprehensive test coverage for critical features:
+
+```bash
+# Run all tests
+pnpm test:run
+
+# Run tests in watch mode
+pnpm test
+```
+
+Test coverage includes:
+- GBFS API integration (bike share data fetching)
+- Mapbox geocoding and geospatial utilities
+- Route calculations and mapping functions
+
+## Project Structure
+
+```
+bikemap/
+├── src/
+│   ├── app/              # Next.js app directory
+│   ├── components/       # React components
+│   │   ├── ui/          # Reusable UI components
+│   │   ├── Map.tsx      # Main map component
+│   │   └── MapMarkers.tsx
+│   ├── data/            # Data sources and types
+│   │   ├── gbfs.ts      # Bike share API integration
+│   │   └── geo_data.ts  # Routes, attractions, resources
+│   ├── utils/           # Utility functions
+│   └── hooks/           # React hooks
+├── public/              # Static assets
+├── tests/               # Test setup and utilities
+└── .github/workflows/   # CI/CD workflows
+```
+
+## Contributing
+
+We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes this project better for everyone.
+
+### How to Contribute
+
+1. **Fork the repository**
+2. **Create a feature branch** (`git checkout -b feature/amazing-feature`)
+3. **Make your changes** and add tests if applicable
+4. **Run tests and linting** (`pnpm test:run && pnpm lint`)
+5. **Commit your changes** (`git commit -m 'Add amazing feature'`)
+6. **Push to your branch** (`git push origin feature/amazing-feature`)
+7. **Open a Pull Request**
+
+### Reporting Issues
+
+Found a bug or have a feature request? Please [open an issue](https://github.com/kwiens/bikemap/issues) with:
+- A clear description of the problem or suggestion
+- Steps to reproduce (for bugs)
+- Screenshots if applicable
+- Your environment (browser, OS, etc.)
+
+### Code of Conduct
+
+This project is dedicated to providing a welcoming and inclusive experience for everyone. Please be respectful and constructive in all interactions.
+
+## Tech Stack
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+- **Framework**: [Next.js](https://nextjs.org/) (React)
+- **Styling**: [Tailwind CSS](https://tailwindcss.com/)
+- **Mapping**: [Mapbox GL JS](https://www.mapbox.com/mapbox-gljs)
+- **UI Components**: [Radix UI](https://www.radix-ui.com/)
+- **Icons**: [Font Awesome](https://fontawesome.com/)
+- **Testing**: [Vitest](https://vitest.dev/)
+- **Package Manager**: [pnpm](https://pnpm.io/)
+- **Linting**: ESLint + [Biome](https://biomejs.dev/)
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+## Dedication
 
-## Learn More
+This project is dedicated to the memory of our friend and collaborator Yoseph. In his honor, consider donating to [Yoseph's Bikes](https://www.whiteoakbicycle.org/yoyobikes) to help children access the joy of riding.
 
-To learn more about Next.js, take a look at the following resources:
+## License
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+This project is open source and available under the [MIT License](LICENSE).
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+## Acknowledgments
 
-## Deploy on Vercel
+- Thanks to the Chattanooga cycling community for route curation and feedback
+- [Bike Chattanooga](https://bikechatt.com) for providing bike share infrastructure
+- [iFixit](https://www.ifixit.com) for supporting open-source community projects
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+---
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+Made with ❤️ in Chattanooga, TN

next-env.d.ts

@@ -1,6 +1,5 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-// eslint-disable-next-line @typescript-eslint/triple-slash-reference
 /// <reference path="./.next/types/routes.d.ts" />
 
 // NOTE: This file should not be edited

package.json

@@ -7,8 +7,10 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-path .gitignore --no-warn-ignored --max-warnings 0 && biome lint && biome format",
-    "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-path .gitignore --no-warn-ignored --fix --max-warnings 0 && biome lint --write --unsafe && biome format --write",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint . --max-warnings 0 && biome lint && biome format",
+    "lint:fix": "eslint . --fix --max-warnings 0 && biome lint --write --unsafe && biome format --write",
     "prepare": "husky"
   },
   "dependencies": {
@@ -35,6 +37,8 @@
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
     "@eslint/eslintrc": "^3.3.3",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.1",
     "@types/node": "^20.19.27",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
@@ -43,10 +47,12 @@
     "eslint-config-next": "15.5.9",
     "eslint-plugin-import": "^2.32.0",
     "husky": "^9.1.7",
+    "jsdom": "^27.4.0",
     "lint-staged": "^16.2.7",
     "postcss": "^8.5.6",
     "sharp": "^0.34.5",
     "tailwindcss": "^3.4.19",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
   }
 }