Getting Started

A step-by-step guide to plotting deed descriptions on real maps. From pasting your first deed to exporting a finished project.



1. Create a Project

A project groups related deeds together — one county, one family, one title chain.

1

Go to the Projects page

Click Projects in the top-right corner, or open the app at /projects.
2

Click “+ New Project”

A dialog opens with fields for project name, description, and default distance unit (feet, chains, rods, etc.).
3

Fill in the details and create

The default unit affects how distances display. You can always change units per-course later. Click Create Project to enter the workspace.

First-time users will see a sample project already created with two demo deeds. You can use it to explore or delete it when you're ready.


2. Manage Projects

The Projects page gives you full control over your projects with search, sort, trash, duplicate, and rename.

1

Search & Sort

Use the search bar to filter projects by name. Sort by Recent, Name A–Z, Name Z–A, or Created date using the sort buttons.
2

Rename a project

Hover over a project card and click the pencil icon. Type the new name and press Enter to confirm or Escape to cancel.
3

Duplicate a project

Hover and click the copy icon. A full copy is created with all deeds, overlays, and layer groups. Names auto-increment: “My Project dup1”, “My Project dup2”, etc.
4

Trash & Restore

Click the trash icon to soft-delete a project. It moves to the Trash section at the bottom of the page. Restore anytime within 30 days, or permanently delete. Expired projects are auto-cleaned.
5

Shared with Me

If someone has shared a project with you (via email), it appears in the Shared with me section with the owner's name and your role (viewer or editor).

Changing the project's default measurement unit converts all displayed distances project-wide — course tables, detail panels, and wizard defaults all update automatically.


3. Add a Deed

Inside a project, the workspace has three panels: a deed list (left), a form/detail panel (center), and the map (right).

1

Click “+ Deed” in the sidebar

A new untitled deed appears in the list. The form opens in the center panel.
2

Choose your entry method

Two tabs: Paste Text (paste raw deed language) or Course Wizard (enter each course manually with dropdowns).

Keyboard shortcut: press N to create a new deed.


4. Paste Deed Text

Copy the metes-and-bounds description from your deed document and paste it into the text area. The parser handles the rest.

Beginning at a stone marker, thence North 45 degrees East 300 feet
to an oak tree, thence South 30 degrees East 200 feet to a creek,
thence South 60 degrees West 300 feet to a stone pile,
thence North 30 degrees West 200 feet back to the Point of Beginning

The parser recognizes many formats:

  • • Standard: N 45°30' E 300 feet
  • • Written: North 45 degrees 30 minutes East 300 feet
  • • Compact: N45.5E 300 ft or S34.3E 200 feet
  • • Bare cardinal: South 80 chains (no degree angle)
  • • Compass rose: Northeast 200 feet, South Southeast 50 rods
  • • Curves: curve to the right radius 200 feet arc 150 feet
  • • Fractional: 15 1/2 poles

Below the text area you'll see “Parsed N courses” and any errors will be highlighted inline with red underlines.


5. Course Wizard

If you prefer entering courses manually, switch to the Course Wizard tab.

1

Click “+ Add Course”

A new row appears with dropdowns for N/S, degree/minute/second fields, E/W, distance, and unit.
2

Fill in each course

For example: N | 45 | 0 | 0 | E | 300 | feet. The SVG preview updates as you type.
3

Reorder or remove

Use the remove button on each row. The preview always reflects the current course list.

Switching between tabs preserves data in both. The active tab determines which courses feed the preview.


6. Preview & Stats

As you enter courses, the SVG preview updates in real time. It shows:

  • • The parcel shape with colored stroke and transparent fill
  • • Course numbers at midpoints
  • • Bearing and distance labels on each line (hidden for 13+ courses)
  • • Direction arrows showing the survey path
  • • A POB (Point of Beginning) marker
  • • Curve arcs with delta angle and radius labels
  • • Meander courses as blue dashed lines

The stats bar below shows the area (acres and sq ft), perimeter, and closure precision ratio (e.g., 1:5000). “Perfect closure” means the parcel closes exactly.


7. Metadata & Declination

Below the courses, fill in the deed metadata:

  • Owner / Grantee — the person receiving the land
  • Grantor — the person granting/selling the land
  • Date — the deed date (a year is enough, e.g. “1788”)
  • Book & Page — the deed book reference
  • Notes — any additional context
  • Magnetic Declination — the compass correction for the time period

For declination: positive values shift bearings east, negative shift west. Click the NOAA button to auto-lookup the historical declination for the deed's date and location (requires the deed to be placed on the map first).

Click Save Deed (or Ctrl+S) to compute geometry and persist.


8. Place on the Map

1

Click “Place on Map” in the detail panel

A banner appears: “Click on the map to place the parcel.”
2

Click on the map

The parcel polygon appears with the owner name label. The anchor point is the Point of Beginning.
3

Reposition if needed

Drag the polygon to move it. Use arrow keys to nudge pixel by pixel. Enter a rotation value in the detail panel to align with known boundaries.

Keyboard shortcut: press P to enter placement mode for the selected deed.


9. Map Tools

Basemaps

Switch between OpenStreetMap, USGS Topo, Satellite, OpenTopoMap, and CartoDB Light using the basemap selector in the bottom-right corner.

Image Overlays

Place a historic map or plat image on the map. Click two corners to position it, then adjust opacity, rotation, and scale. Drag corners to resize. Overlays sync to the cloud when signed in.

Layer Groups

Organize deeds into named groups. Drag and drop deeds between groups, collapse/expand groups in the sidebar, and toggle visibility per group.

Save View

Click “Save View” in the bottom-left to save the current map position and zoom as the project default.

Export Image

Click “Export Image” to save the current map view as a JPG screenshot.

Shared Boundaries

When multiple deeds share an edge, it's highlighted in orange with a tooltip showing the shared bearing and distance.

PLSS Grid

PLSS deeds show a 6×6 township section grid overlay with serpentine numbering and the relevant section highlighted.


10. Search & Filter

The sidebar includes a search bar that searches across all deed fields (owner, grantor, date, book/page, notes). Matches are highlighted in the results.

The “As of Date” slider lets you filter deeds by year. Drag the range to show only deeds from a specific time period. Click “Show All” to reset. Both the sidebar list and the map respect this filter.


11. Table View

Toggle between Map and Table view using the switch in the header. The table shows all deeds in a grantor-grantee format, sortable by 7 columns: Grantor, Grantee (owner), Date, Book/Page, Acres, Courses, and Status (placed/unplaced).

Click any row to select the deed and open its detail panel. The table respects search and date filters.


12. Export

Export buttons are in the project header. Each format has a specific use:

JSON

Full project backup. Includes all deeds, geometry, and metadata. Can be re-imported.

KML

For Google Earth. Only includes deeds placed on the map (needs lat/lng coordinates).

GeoJSON

Standard GIS format. Works with QGIS, Mapbox, and other mapping tools.

CSV

Spreadsheet format. One row per course with bearing, distance, unit, area, and closure data.

MBL

DeedMapper native format. Useful if you need to share with DeedMapper users.

Shapefile

SHP format for professional GIS applications. WGS84 projection.


13. Import

On the Projects page, click Import and select a file. Two formats are supported:

  • .json — btdeed project files (full round-trip with all data)
  • .mbl — DeedMapper files (courses, metadata, owner name, date)

MBL import creates a new project with the deed data from the file. If you're migrating from DeedMapper, this is the easiest way to bring your work over.


14. Cloud & Sharing

btdeed works without an account — everything saves locally in your browser. Sign in to unlock cloud features:

1

Sign up or sign in

Click the avatar in the top-right corner. Create an account with email and password, or sign in if you already have one.
2

Auto-sync

Projects created while signed in automatically save to the cloud. Changes sync across devices. The header shows “Saved X ago” as confirmation.
3

Share a project

Click the Share button in the project header. Share via email (viewer or editor role) or create an anonymous link anyone can use.
4

Collaborate in real time

When others open your shared project, you'll see their presence avatars in the header. Changes appear live — no refresh needed.
5

Browse shared projects

Projects shared with you appear in the Shared with me section on the Projects page. You'll see the owner's name and your role (viewer/editor) as a badge.

Viewer role can browse and export but not edit. Editor role can create, edit, and delete deeds. Only the project owner can manage sharing.


15. Keyboard Shortcuts

Press ? at any time to see the full shortcuts dialog. Here are the most useful:

NNew deed
EEdit selected deed
PPlace selected deed on map
Delete / BackspaceDelete selected deed
EscapeClose panel / cancel placing
Ctrl+SSave deed (when editing)
Ctrl+ZUndo
Ctrl+Shift+ZRedo
← ↑ → ↓Nudge placed parcel
1 / 2 / 3Switch mobile tabs
?Toggle shortcuts help

16. Print at Scale

The print view generates a scaled map with professional output. Access it from the deed detail panel.

  • • Selectable scale (1:1200, 1:2400, 1:4800, etc.)
  • • North arrow and scale bar
  • • Course table with all bearings, distances, and landmarks
  • • Owner name, date, and area information
  • • Use your browser's print dialog (Ctrl+P) to print or save as PDF

17. PLSS Descriptions

PLSS (Public Land Survey System) descriptions like “the SE 1/4 of the NE 1/4 of Section 21, Township 4 South, Range 4 East” are parsed automatically.

The SE 1/4 of the NE 1/4 of Section 21, Township 4 South, Range 4 East of the Third Principal Meridian
  • • Formal, compact, and dotted formats supported
  • • Quarter subdivisions (NE 1/4, SW 1/4 of NE 1/4, etc.)
  • • Auto-generates rectangular geometry with acreage
  • • Township grid overlay appears on the map
  • • PLSS description shown in the detail panel with acreage breakdown

18. DeedMapper (MBL) Workflow

MBL files from DeedMapper often hold thousands of deeds that need cleanup before they look right on a real map. btdeed gives imported MBL projects their own toolbar and an Illustrator-style edit mode so you can refine the whole cluster without saving after every nudge.

1

Import the .mbl file

On the Projects page click Import and choose your .mbl. btdeed parses every deed, auto-detects the loc coordinate unit, and anchors the cluster on the county centroid inferred from the filename. The new project opens with an onboarding banner showing the filename, deed count, anchor county, and detected unit. Click Got it to dismiss.
2

Use the Alignment Toolbar

MBL projects get a floating toolbar in the top-left of the map (next to the zoom buttons). Every refinement tool lives there: realign all, overlap highlights, edit mode, and the Done button to convert back to a normal project.
3

Realign the whole cluster

Select any deed you can identify on a real landmark. Click Realign all from selected, then click the spot on the map where that deed actually belongs. Every deed in the project shifts by the same delta in one batched operation.
4

Spot overlaps

Click Show overlaps. Polygons that overlap another deed turn red. Some are real (resurveys), but most come from closure-error drift and are candidates for individual nudging.
5

Enter Edit Mode

Click Edit mode in the toolbar. Now you can:
  • Drag any deed to nudge it freely.
  • Drag empty space to draw a marquee rectangle and select every deed inside.
  • Shift-click a deed to add or remove it from the selection. Shift-marquee adds to the selection.
  • Drag any selected deed to move the whole group together.
  • Arrow keys nudge the selection one pixel; Shift+Arrow nudges 10×.
  • Esc clears the selection.
6

Save with Cmd+S

Drag offsets buffer in memory — nothing writes to disk mid-drag. The toolbar shows ● N unsaved as you work. Press Cmd+S (or click Save) to flush every pending offset in one Dexie transaction and one bulk cloud upsert. Discard throws the buffer away. If you try to leave the page with unsaved drags, the browser will warn you.
7

Convert when you're done

Once the cluster looks right, click Done — convert to normal project at the bottom of the toolbar. The MBL tag and alignment tools disappear and the project behaves like any other btdeed project. Deeds keep their current positions.

Large MBL projects (300+ deeds) automatically render through a high-performance canvas layer with viewport culling, so even 5,000-deed clusters stay smooth.


19. Tips & Tricks

Closure doesn't match?

Old deeds often have survey errors. Use the Compass Rule (Bowditch) adjustment button in the detail panel to distribute the closure error proportionally across all courses.

Parcel doesn't align with modern roads?

Try adjusting the magnetic declination. Historic compass readings drift over time. Use the NOAA lookup for the deed's date and location, or experiment with values manually.

Compare old and new maps

Use the image overlay feature to place a historic plat map on the modern map. Adjust opacity to see how boundaries have changed over time.

Working with DeedMapper files?

Import .mbl files directly. btdeed reads all DeedMapper course data, metadata, and owner information. You can also export back to .mbl if needed.

Need to share with someone who doesn't have an account?

Create an anonymous share link. Anyone with the link can view the project without signing in. Revoke the link anytime from the share dialog.