Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jacobsamo/buzztrip/llms.txt

Use this file to discover all available pages before exploring further.

BuzzTrip is an open-source collaborative mapping platform built as a modern alternative to Google My Maps. It lets individuals and teams create richly annotated custom maps — dropping markers, drawing paths and shapes, organizing locations into collections, and sharing the results with collaborators in real time. Whether you are planning a trip, scouting shoot locations, or coordinating an event, BuzzTrip adapts to the scale and purpose of any mapping project.

What You Can Do

BuzzTrip gives you a full toolkit for building and maintaining custom maps from the browser:
  • Create and manage maps — spin up multiple maps, each with its own title, description, visibility level, and starting location.
  • Add markers — drop a pin anywhere on the map or tap a point of interest to pull in rich place data from Google Maps or Mapbox.
  • Organize with collections — group related markers under named, color-coded collections for clean visual hierarchy.
  • Draw paths and shapes — use the drawing tools to sketch lines, circles, rectangles, and polygons; measurements update in real time as you draw.
  • Collaborate in real time — invite teammates and see everyone’s changes appear instantly, powered by Convex’s reactive database.
  • Control access — assign each collaborator a role (owner, editor, viewer, or commenter) so you stay in charge of who can change what.

Technology Stack

BuzzTrip is built on a modern, fully open-source-friendly stack:
LayerTechnology
Frontend frameworkNext.js 15
Real-time backendConvex
AuthenticationClerk
StylingTailwind CSS
Mapping providersGoogle Maps · Mapbox
Package managerBun (monorepo via Turborepo)

Current Status

BuzzTrip is currently in public beta and is free to use at buzztrip.co. No credit card is required to sign up. Core mapping features are stable and actively used in production; additional capabilities — including native mobile apps, advanced import/export, and enhanced collaboration tooling — are on the public roadmap.
BuzzTrip is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This means the source code is freely available, and any modifications you deploy publicly must also be made open source under the same license.

Explore the Docs

Quickstart

Create your first map and add markers in under 5 minutes.

Maps

Learn how to create, configure, and manage maps.

Sharing & Permissions

Invite collaborators and control access with role-based permissions.

Backend Overview

Understand how Convex powers BuzzTrip’s real-time data layer.

Key Features

  • Custom markers — place a marker at any coordinate; set a title, note, icon, and color, then assign it to a collection.
  • Collections — named, icon-adorned groups that keep related markers visually organized and easy to filter.
  • Paths & shapes with measurements — draw lines, circles, rectangles, and polygons with live distance and area calculations via Terra Draw.
  • Real-time collaboration — Convex subscriptions push every change to all connected users instantly, with no manual refresh needed.
  • Role-based permissions — four roles (owner, editor, viewer, commenter) give fine-grained control over who can modify a map.
  • Multiple map styles — choose from hybrid, roadmap, satellite, or terrain base layers for the right visual context.
  • Map duplication — clone any map to use it as a starting template for a new project.
  • Rich place data — search and pull POI details from Google Maps and Mapbox directly into your markers.

Build docs developers (and LLMs) love