Map_MarkUp

Help Guide

Use this guide to create projects, mark streets, share progress, and manage the team at map-markup.com.

Not signed in

Getting Started

Sign In And Pick A Project

Open the app, sign in or create an account, then choose a project from the Projects page. Each project keeps its own street highlights, notes, members, and stats.

Your username is shown beside street edits, notes, runner totals, and project activity. If your session expires, the app asks you to sign in again before saving shared changes.

Example of the Map_MarkUp projects screen showing available projects and create project controls
Example photo: Projects screen with open, join, and create project options.

Create Or Join A Project

Create a project with a name, optional description, and project key. To join someone else's project, open their shared link or scan their QR code, then enter the project key if the app asks for it.

Project admins can change the project name, description, key, member roles, and access settings from the Admin Dashboard.

Move Around The Map

Drag to pan, pinch or scroll to zoom, and tap or click any road to open its action menu.

The Location button asks for browser permission, flies to your current position, and drops a red pin marker.

Example of map controls including location, guide, share, project menu, and progress counters
Example photo: Main map controls, active project, active user, zoom, and progress counters.

Mark A Street Status

Select a street to open the status popup, then choose Plan, Done, Partial, or Remove. The app stores who made the change, when it happened, and the previous status so the team can see the latest update details.

Blue means planned, green means done, yellow means partial, and remove clears the map highlight. If the sync server is offline, changes stay in local storage until the connection is available again.

Example of a selected street popup with Plan, Done, Partial, Remove, and Notes buttons
Example photo: Street popup with status buttons and note access.

Share A Project

Use the Share button on the map to copy the project link, copy the project key, or generate a downloadable share image with a QR code.

New users can scan the QR code, create an account, and join the project immediately. Manual joins can still use the project key.

Example of the Share Project popup with QR image preview, project link, and project key
Example photo: Share Project popup with QR image, link, and project key.

Team Tools

Add Shared Street Notes

Marked streets include a Notes button. Open it to read the shared note history for that street and add a new update for the team.

Notes keep the author name and timestamp. The Street Notes page lists every street with notes and includes a status filter so you can review planned, partial, done, and unmarked streets quickly.

Example of the Street Notes page showing note history and a status filter
Example photo: Street Notes page with note history, filters, and remove controls.

Use Area Select For Bulk Updates

Press Area Select, then drag a box across the roads you want to update together. When you release, the selected streets are highlighted and a bulk action popup lets you apply one status to the whole selection.

The bulk popup shows your signed-in display name. Use Cancel Bulk to leave box-select mode, or drag a new box to replace the current selection. Area Select is hidden on small touch screens where box selection is less reliable.

Example of area select drawing a box around multiple streets for bulk status updates
Example photo: Area Select box with selected streets ready for a bulk update.

Read Stats And Progress

The map counter shows planned, completed, and partial street totals while you work. The Project Stats page gives a wider view with street counts, percentages, and runner totals grouped by editor.

Project totals update from shared server data when available. Local fallback data is still saved in your browser so work is not lost during sync outages.

Example of project stats showing planned, partial, completed, and runner totals
Example photo: Project Stats page with status totals and runner data.

Admin Tools

Open The Project Menu

The menu button opens project actions: switch project, sign out, open the Admin Dashboard, view Stats, open Notes, or close the menu.

Only project admins see the Admin Dashboard button. Regular members can still mark streets, add notes, read stats, and share project access when allowed by the project workflow.

Manage Members And Project Details

Admins can update the project name, description, and project key. They can also refresh the member list, promote members to admin, return admins to member, and remove users from the project.

Example of the Admin Dashboard with project details, project members, and terminal panels
Example photo: Admin Dashboard with project details, member controls, and terminal activity.

Clear Or Delete Project Data

Admins can clear all shared street statuses and notes for the selected project. They can also delete the project after confirming their username and password.

These actions affect the selected project only. Deleting a project removes its members, street statuses, notes, and project record.

Add Your Own Example Photos

Replace the sample image paths in this guide with screenshots or photos from your own workflow.

Recommended files: images/help/projects-example.jpg, map-controls-example.jpg, street-status-example.jpg, street-notes-example.jpg, area-select-example.jpg, stats-example.jpg, share-project-example.jpg, and admin-dashboard-example.jpg.