FoodTruckNerdz – Next.js App

A modern implementation of the FoodTruckNerdz application using Next.js, Tailwind CSS, shadcn/ui, and Zustand.

Features

Patrons

  • Search for food trucks by name

  • View food trucks on a map

  • Get current location of food truck

  • Responsive design for mobile and desktop

Owners

  • Register a food truck linked to Square POS

  • Enhanced Check-in System:

    • GPS-based nearby addresses discovery

    • Advanced map-based location selection

    • Distance indicators for nearby addresses

    • One-click check-in from nearby locations

    • Automatic checkout with time spans

  • Food truck management (CRUD operations)

  • Square integration for menu sync

Technologies Used

  • Next.js 15: React framework with App Router

  • React 19: UI library

  • Tailwind CSS 4: Utility-first CSS framework

  • shadcn/ui: Reusable UI components built with Radix UI

  • Zustand: State management library

  • Radar SDK: Maps and location services

  • Convex: Backend database and real-time sync

  • Square API: POS integration

Project Structure

ftn-nextjs/
├── app/              # Next.js App Router
│   ├── actions/      # Server actions
│   ├── api/          # API routes
│   └── manage/       # Management pages
├── components/       # React components
│   ├── ui/           # shadcn/ui components
│   ├── food-trucks/  # Food truck components
│   ├── map/          # Map components
│   └── checkin/      # Check-in components
├── convex/           # Convex backend
├── lib/              # Utility functions
├── store/            # Zustand stores
└── public/           # Static assets

Getting Started

Choose one of the following paths:

  • Option A: Manual Setup (DIY) (baseline, cross-platform)

  • Option B: External Dev Setup App (optional UX)

Development Scripts

  • run.ps1 – Start dev server, build, lint, format

Environment Variables

See Manual Setup for details.

Documentation