// TerraGenie Support — structured content from User Guide 2026 // Each section mirrors the manual flow; steps / callouts / ui-refs are structured data. const SUPPORT_SECTIONS = [ // ————————————————————————————————————————————————————————— { id: "kit", num: "01", title: "Your TerraGenie Kit", sub: "What's in the box and what each component does.", category: "Getting Started", keywords: "kit box unboxing antenna tablet pole charger mount bracket components", icon: "box", video: null, content: [ { kind: "p", text: "Your TerraGenie kit ships with everything needed to run layout on day one. Check that all of the following components are present before heading to the jobsite:" }, { kind: "kit", items: [ { label: "TerraGenie TG2 Antenna", icon: "antenna" }, { label: "Rugged Tablet", icon: "tablet" }, { label: "Carbon Fiber Survey Pole", icon: "pole" }, { label: "Antenna Charger", icon: "charger" }, { label: "Tablet Mounting Bracket", icon: "bracket" }, { label: "Tablet Charger", icon: "charger" } ]}, { kind: "callout", variant: "tip", title: "Before you leave the yard", body: "Verify all components are present and fully charged. Losing a shift to a dead battery is the most avoidable problem on any jobsite." } ] }, // ————————————————————————————————————————————————————————— { id: "startup", num: "02", title: "Turning On Your System", sub: "Power up, launch the app, and verify a valid GNSS fix.", category: "Getting Started", keywords: "power on start boot fix rtk float imu calibrate antenna tablet connect launch", icon: "power", video: null, content: [ { kind: "step", n: "1", title: "Prepare the equipment", body: [ { kind: "li", text: "Ensure all components are present: Antenna, Tablet, Pole, and mounting accessories." }, { kind: "li", text: "Verify that all devices are fully charged." } ]}, { kind: "step", n: "2", title: "Power on the TG2 Antenna", body: [ { kind: "li", text: "Press and hold the power button until a yellow light appears, followed by a blinking red light." }, { kind: "li", text: "Turn on the tablet." }, { kind: "li", text: "In the tablet, open the connector and tap Start." } ]}, { kind: "step", n: "3", title: "Launch TerraGenie", body: [ { kind: "li", text: "On the tablet, open the TerraGenie app." }, { kind: "li-ui", text: "If you can't find the shortcut, open a browser and go to ", ref: { text: "terra-genie.com/web", icon: "web" } } ]}, { kind: "step", n: "4", title: "Verify positioning", body: [ { kind: "li", text: "Check the map screen." }, { kind: "li", text: "Confirm that your current location is visible." } ]}, { kind: "h4", text: "Understanding position status" }, { kind: "status", rows: [ { dot: "green", title: "Green (float)", desc: "Wait or move to a different location until the dot turns blue." }, { dot: "blue-x", title: "Blue dot with X", desc: "IMU not yet fully calibrated. Move the pole rapidly in a wide angle to resolve." }, { dot: "blue", title: "Blue dot (no X)", desc: "Valid fix. The system is ready to use." } ]}, { kind: "callout", variant: "success", title: "System Ready", body: "Once a valid fix is achieved, you're ready to begin working." }, { kind: "callout", variant: "note", title: "Data tips", body: "Use clear file names (avoid special characters). Regularly export and back up your data. Use TGD format for faster loading and performance." } ] }, // ————————————————————————————————————————————————————————— { id: "interface", num: "03", title: "Interface Introduction", sub: "Every button and icon on the main map screen, explained.", category: "Getting Started", keywords: "interface ui buttons icons menu drop down dxf location layers zoom select cursor polygon polyline point circle query", icon: "map", video: "assets/support/videos/interface-intro.mp4", content: [ { kind: "p", text: "This is a reference map of the main screen. Hover or tap any number on the screenshot to see what it does. You'll use these buttons in every workflow that follows." }, { kind: "iface-annotated", image: "assets/software/screen-2.jpg", rows: [ // Positions are percentages of the reference screenshot (608 × 999 view). { n: 1, icon: "user", x: 62, y: 4, title: "User name", desc: "Currently logged-in user. Tap to log out." }, { n: 2, icon: "dropdown", x: 78, y: 11, title: "Category drop-down", desc: "Select the right category (points, polylines, polygons) before marking anything." }, { n: 3, icon: "dxf", x: 92, y: 19, title: "DXF · Files", desc: "Import or export CAD files: DXF, TGD and CSV." }, { n: 4, icon: "save", x: 92, y: 31, title: "Save Location", desc: "Capture the current fix and save it to your project." }, { n: 5, icon: "location", x: 92, y: 43, title: "Location · Arrow", desc: "Start/stop stakeout. Also toggles arrow mode." }, { n: 6, icon: "query", x: 92, y: 53, title: "Query", desc: "Group points, generate reports, view feature details." }, { n: 7, icon: "layers", x: 92, y: 65, title: "Layers", desc: "Toggle Google, OpenStreetMap, DXF and WMS overlays." }, { n: 8, icon: "refresh", x: 92, y: 75, title: "Refresh", desc: "Pull fresh data from the server." }, { n: 9, icon: "stakeout", x: 92, y: 87, title: "Stakeout", desc: "Toggle stakeout mode. Frame turns green when active." }, { n: 10, icon: "zoom", x: 9, y: 23, title: "Zoom · Fit", desc: "Zoom in, out, or fit-to-extent." }, { n: 11, icon: "select", x: 9, y: 56, title: "Select features", desc: "Pointer tool for picking points, lines and areas." }, { n: 12, icon: "draw", x: 9, y: 72, title: "Drawing tools", desc: "Polygon, polyline, point, circle, typed X,Y,Z entry." }, { n: 13, icon: "undo", x: 9, y: 83, title: "Undo history", desc: "Your last 10 actions. Tap any row to revert to that state." } ]} ] }, // ————————————————————————————————————————————————————————— { id: "import", num: "04", title: "Import a Plan (DXF / TGD)", sub: "Load your CAD drawings into the project.", category: "Workflow", keywords: "import plan cad dxf tgd file upload choose load", icon: "upload", video: null, content: [ { kind: "p", text: "TerraGenie accepts standard CAD in DXF format or the optimized TGD format for faster performance on large drawings." }, { kind: "step", n: "1", title: "Open the import menu", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "DXF", icon: "dxf" }, suffix: " button (first icon on the right side of the screen)." }, { kind: "li", text: "The import window will open." } ]}, { kind: "step", n: "2", title: "Select your file", body: [ { kind: "li", text: "Tap Choose File." }, { kind: "li", text: "Select DXF (standard CAD) or TGD (TerraGenie Data format)." } ]}, { kind: "step", n: "3", title: "Import the file", body: [ { kind: "li", text: "Tap Import from DXF." }, { kind: "li", text: "The plan will load into your project." } ]}, { kind: "h4", text: "TGD format (recommended)" }, { kind: "p", text: "TGD is TerraGenie's internal format, designed for fast and efficient loading of large drawings." }, { kind: "step", n: "→", title: "To save a file as TGD", body: [ { kind: "li", text: "After importing a DXF file, tap the DXF button." }, { kind: "li", text: "Tap Export to TGD." }, { kind: "li", text: "Save the file to your device." } ]}, { kind: "callout", variant: "tip", title: "For future use", body: "Import the TGD file directly instead of the original DXF. Performance is noticeably better on large drawings." }, { kind: "callout", variant: "warn", title: "Important", body: "Files with special characters or parentheses (e.g. '(1)') may fail to import. Rename the file first if needed. Large DXF files may take longer to load." }, { kind: "callout", variant: "success", title: "After import", body: "The plan appears on the map. You can now perform stakeout (layout), snap with arrow mode, mark points/lines/areas, and begin working directly on your plan." } ] }, // ————————————————————————————————————————————————————————— { id: "stakeout", num: "05", title: "Stakeout / Layout", sub: "Navigate in real time to any point, line, or area on your plan.", category: "Workflow", keywords: "stakeout layout navigate target arrow mode point line area blue distance tolerance", icon: "target", video: "assets/support/videos/stakeout.mp4", content: [ { kind: "p", text: "Stakeout lets you navigate in real time to a selected point, line, or area directly from your plan." }, { kind: "step", n: "1", title: "Start stakeout", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "Location", icon: "location" }, suffix: " button (third icon on the right)." }, { kind: "li", text: "Tap the Start Stakeout button." } ]}, { kind: "step", n: "2", title: "Enable arrow mode", body: [ { kind: "li", text: "Tap the white cube icon." }, { kind: "li", text: "Close the window." }, { kind: "li-ui", text: "Tap the ", ref: { text: "Stakeout", icon: "stakeout" }, suffix: " button (last icon on the right)." } ]}, { kind: "callout", variant: "tip", title: "Stakeout is active when…", body: "The button frame is highlighted in green. A blue arrow appears when you touch the screen." }, { kind: "step", n: "3", title: "How to use it", body: [ { kind: "li", text: "Drag your finger on the screen." }, { kind: "li", text: "Snap the center of the arrow with the target (for example, the wanted point)." }, { kind: "li", text: "A light blue line appears between you and the target. Follow the line to the target." } ]}, { kind: "h4", text: "Display information" }, { kind: "p-ul", items: [ "Top line: distance to target.", "Values in parentheses: height difference.", "Use the zoom controls on the left to zoom in and out." ]}, { kind: "callout", variant: "success", title: "Getting close", body: "When you are within approximately 2 inches (5 cm) of the target, the line changes to green." } ] }, // ————————————————————————————————————————————————————————— { id: "mark-point", num: "06", title: "Mark a Point", sub: "Capture a precise point location and save it to your project.", category: "Capture", keywords: "mark point save location capture type sub type planned height cut fill", icon: "pin", video: "assets/support/videos/mark-point.mp4", content: [ { kind: "p", text: "Use this feature to capture an accurate point location in the field and store it within your project." }, { kind: "step", n: "1", title: "Select Points mode", body: [ { kind: "li", text: "Make sure the dropdown menu in the top right is set to Points." } ]}, { kind: "step", n: "2", title: "Save location", body: [ { kind: "li-ui", text: "Tap the red ", ref: { text: "Save Location", icon: "save" }, suffix: " button on the right side." }, { kind: "li", text: "A new point capture window will open." } ]}, { kind: "step", n: "3", title: "Define point details", body: [ { kind: "li", text: "Select the Point Type." }, { kind: "li", text: "Select the Sub-Type." } ]}, { kind: "callout", variant: "tip", title: "Choose the correct type", body: "Pick the type that matches what you're marking in the field. This drives the AutoCAD layer name on export." }, { kind: "step", n: "4", title: "Enter planned height (optional)", body: [ { kind: "li", text: "Enter a planned height if required." }, { kind: "li", text: "Use planned height when working with grading or elevation." } ]}, { kind: "callout", variant: "note", title: "Automatic cut/fill", body: "TerraGenie will automatically calculate and display Cut (material to remove) and Fill (material to add) based on the planned height." }, { kind: "step", n: "5", title: "Save the point", body: [ { kind: "li", text: "Tap Save." } ]}, { kind: "callout", variant: "success", title: "Point created", body: "The point appears on the map and is saved within your project. It's now available for stakeout, reporting, and export." } ] }, // ————————————————————————————————————————————————————————— { id: "create-line", num: "07", title: "Create a Line", sub: "Capture multiple points and group them into a continuous line.", category: "Capture", keywords: "line polyline group points sequence convert linestring line type", icon: "line", video: "assets/support/videos/create-line.mp4", content: [ { kind: "p", text: "Lines are created by capturing multiple points in the field and grouping them into a single continuous line." }, { kind: "step", n: "1", title: "Switch to Points Before Grouping", body: [ { kind: "li", text: "In the top-right dropdown, select Points Before Grouping." } ]}, { kind: "step", n: "2", title: "Capture points", body: [ { kind: "li-ui", text: "Tap the red ", ref: { text: "Save Location", icon: "save" }, suffix: " button." }, { kind: "li", text: "In the window, select an empty group." }, { kind: "li", text: "Tap Save." }, { kind: "li", text: "Continue capturing points along the desired path." } ]}, { kind: "callout", variant: "warn", title: "Confirm the group is empty first", body: "Tap the Query tool and check the list of groups. If the group name appears in the list, it's already in use and will mix points." }, { kind: "step", n: "3", title: "Follow the correct order", body: [ { kind: "li", text: "Points must be captured in the correct sequence." }, { kind: "li", text: "The line will follow the order in which points were recorded." } ]}, { kind: "step", n: "4", title: "Group points into a line", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "Query", icon: "query" }, suffix: " button." }, { kind: "li", text: "Tap Group." }, { kind: "li", text: "Select the relevant group." } ]}, { kind: "step", n: "5", title: "Convert to a line", body: [ { kind: "li", text: "Under the grouping options, select Lines from the dropdown menu." }, { kind: "li", text: "Tap the To Linestring button." }, { kind: "li", text: "Choose the appropriate Line Type." }, { kind: "li", text: "Tap Save." } ]}, { kind: "callout", variant: "success", title: "Line created", body: "The line appears on the map, saved within your project and ready for layout (stakeout), measurement, or export." }, { kind: "h4", text: "Important: keep or delete points" }, { kind: "p", text: "By default, points used to create the line are deleted after grouping. To keep the original points, change the point destination setting before converting:" }, { kind: "p-ul", items: [ "\"Points Delete\" → \"Points\"" ]}, { kind: "callout", variant: "tip", title: "Best practices", body: "Ensure the group is empty before starting. Confirm the correct group before saving points. Double-check point order before grouping." } ] }, // ————————————————————————————————————————————————————————— { id: "create-area", num: "08", title: "Create an Area (Polygon)", sub: "Capture points and group them into a closed polygon.", category: "Capture", keywords: "area polygon perimeter points group closed sub type clockwise counterclockwise", icon: "polygon", video: "assets/support/videos/polygon.mp4", content: [ { kind: "p", text: "An area is created by capturing multiple points in the field and grouping them into a closed polygon." }, { kind: "step", n: "1", title: "Switch to Points Before Grouping", body: [ { kind: "li", text: "In the top-right dropdown, select Points Before Grouping." } ]}, { kind: "step", n: "2", title: "Capture points around the perimeter", body: [ { kind: "li-ui", text: "Tap the red ", ref: { text: "Save Location", icon: "save" }, suffix: " button." }, { kind: "li", text: "Select an empty group, then tap Save." }, { kind: "li", text: "Continue capturing points along the perimeter." } ]}, { kind: "callout", variant: "warn", title: "Confirm the group is empty first", body: "Tap the Query tool and check the list of groups. If the group appears in the list, it's already in use." }, { kind: "step", n: "3", title: "Follow the correct order", body: [ { kind: "li", text: "Points must be captured in sequence around the perimeter." }, { kind: "li", text: "The area is created based on the order of the points." } ]}, { kind: "step", n: "4", title: "Group the points", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "Query", icon: "query" }, suffix: " button." }, { kind: "li", text: "Tap Group." }, { kind: "li", text: "Select the relevant group." } ]}, { kind: "step", n: "5", title: "Convert to a polygon", body: [ { kind: "li", text: "Under the grouping options, select Areas (polygons) from the dropdown menu." }, { kind: "li", text: "Tap the To Polygon button." }, { kind: "li", text: "Select Area Type and Sub-Type, then tap Save." } ]}, { kind: "callout", variant: "success", title: "Area created", body: "The area appears on the map as a closed polygon, saved within your project and ready for use." }, { kind: "h4", text: "Important: keep or delete points" }, { kind: "p", text: "By default, points used to create the area are deleted after grouping. To keep them, change the point destination setting (\"Points Delete\" → \"Points\") before converting." }, { kind: "callout", variant: "tip", title: "Best practices", body: "Ensure the group is empty before starting. Capture points in a consistent direction (all clockwise or all counterclockwise). Double-check point order before grouping." } ] }, // ————————————————————————————————————————————————————————— { id: "export", num: "09", title: "Export to CSV / DXF", sub: "Send selected features to CAD or spreadsheet formats.", category: "Data", keywords: "export csv dxf cad autocad spreadsheet select features data", icon: "export", video: "assets/support/videos/export-dxf.mp4", content: [ { kind: "p", text: "Export selected elements from your project as DXF (for CAD) or CSV (for data use)." }, { kind: "step", n: "1", title: "Select elements", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "Select Features", icon: "select" }, suffix: " tool on the left side of the screen." }, { kind: "li", text: "Draw a selection area around the desired Points, Lines, or Areas." }, { kind: "li", text: "Selected elements appear in blue." } ]}, { kind: "step", n: "2", title: "Export", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "DXF", icon: "dxf" }, suffix: " button (first icon on the right)." }, { kind: "li", text: "Tap Export to DXF or Export to CSV." } ]}, { kind: "callout", variant: "note", title: "Count preview", body: "The number of selected features appears next to the export options so you can confirm before exporting." }, { kind: "step", n: "3", title: "Save the file", body: [ { kind: "li", text: "Choose the file location on your device." }, { kind: "li", text: "Save the file." } ]}, { kind: "callout", variant: "success", title: "Export complete", body: "Your file is ready for AutoCAD and other CAD software (DXF), or spreadsheets and data systems (CSV)." } ] }, // ————————————————————————————————————————————————————————— { id: "quantity", num: "10", title: "Quantity Report", sub: "Generate a Bill of Quantities from the visible features.", category: "Data", keywords: "quantity report bill boq visible screen download", icon: "report", video: null, content: [ { kind: "p", text: "Generate a Bill of Quantities report based on the elements currently displayed on the screen." }, { kind: "step", n: "1", title: "Adjust the view", body: [ { kind: "li", text: "Navigate the map so only the relevant points, lines, and areas are visible." } ]}, { kind: "callout", variant: "note", title: "Visible features only", body: "The report includes only the elements currently on screen. Zoom and pan first to filter what gets counted." }, { kind: "step", n: "2", title: "Open the Query menu", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "Query", icon: "query" }, suffix: " button." }, { kind: "li", text: "In the window that opens, select Bill of Quantities at the bottom." }, { kind: "li", text: "Tap the Report button." }, { kind: "li", text: "Wait a few seconds for the report to generate." }, { kind: "li", text: "Tap Download to open or save the report." } ]}, { kind: "callout", variant: "success", title: "Report ready", body: "Your Bill of Quantities is saved and ready to share with the office." } ] }, // ————————————————————————————————————————————————————————— { id: "import-csv", num: "11", title: "Import a CSV File", sub: "Bring coordinate data in as points on the map.", category: "Data", keywords: "import csv coordinates x y z name utf 8 format", icon: "csv", video: null, content: [ { kind: "p", text: "Import coordinate data from a CSV file and display it as points on the map." }, { kind: "h4", text: "CSV file format requirements" }, { kind: "p", text: "Before importing, ensure your CSV file follows this exact structure:" }, { kind: "p-ul", items: [ "Name", "X coordinate", "Y coordinate", "Z coordinate" ]}, { kind: "callout", variant: "warn", title: "File encoding", body: "Save the file as CSV UTF-8. Other encodings may fail to parse." }, { kind: "step", n: "→", title: "Import", body: [ { kind: "li-ui", text: "Tap the ", ref: { text: "DXF", icon: "dxf" }, suffix: " button (first icon on the right)." }, { kind: "li", text: "Tap Choose File and select your CSV." }, { kind: "li", text: "Tap Import from CSV." } ]} ] }, // ————————————————————————————————————————————————————————— { id: "point-types", num: "12", title: "Add Point Types", sub: "Create categories so your field captures map cleanly to CAD layers.", category: "Admin", keywords: "point type sub type category autocad layer english letters", icon: "pin", video: "assets/support/videos/point-types.mp4", content: [ { kind: "p", text: "Point types let you categorize and organize points based on their purpose in the field." }, { kind: "step", n: "1", title: "Open the point-types menu", body: [ { kind: "li", text: "Go to Point Types on the top-right menu." }, { kind: "li-ui", text: "Tap the ", ref: { text: "Query", icon: "query" }, suffix: " button to view or edit existing types." } ]}, { kind: "h4", text: "Add a new point type" }, { kind: "step", n: "→", title: "Create the type", body: [ { kind: "li-ui", text: "Tap ", ref: { text: "Save Location", icon: "save" }, suffix: "." }, { kind: "li", text: "Enter the new point type and tap Save." } ]}, { kind: "h4", text: "Add a sub-type" }, { kind: "step", n: "→", title: "Create the sub-type", body: [ { kind: "li", text: "Go to Point Subtypes on the top-right menu." }, { kind: "li-ui", text: "Tap ", ref: { text: "Save Location", icon: "save" }, suffix: "." }, { kind: "li", text: "Select the parent type (point type dropdown)." }, { kind: "li", text: "Enter the AutoCAD layer name." } ]}, { kind: "callout", variant: "warn", title: "English letters only", body: "AutoCAD layer names must use English letters only. Non-ASCII characters will fail on export." } ] }, // ————————————————————————————————————————————————————————— { id: "line-types", num: "13", title: "Add Line Types", sub: "Define reusable line categories and their CAD layers.", category: "Admin", keywords: "line type edit delete autocad layer", icon: "line", video: "assets/support/videos/line-types.mp4", content: [ { kind: "step", n: "1", title: "Open the line-types menu", body: [ { kind: "li", text: "Go to Line Types on the top-right menu." }, { kind: "li-ui", text: "Tap the ", ref: { text: "Query", icon: "query" }, suffix: " button to view, edit, or delete existing types." } ]}, { kind: "h4", text: "Add a new line type" }, { kind: "step", n: "→", title: "Create the type", body: [ { kind: "li", text: "Go to Line Types on the top-right menu." }, { kind: "li-ui", text: "Tap ", ref: { text: "Save Location", icon: "save" }, suffix: "." }, { kind: "li", text: "Define the Line type and AutoCAD layer name." }, { kind: "li", text: "Tap Save." } ]} ] }, // ————————————————————————————————————————————————————————— { id: "polygon-types", num: "14", title: "Add Polygon Types", sub: "Create area categories and sub-types for CAD export.", category: "Admin", keywords: "polygon area type sub type layer english letters", icon: "polygon", video: null, content: [ { kind: "step", n: "1", title: "Open the polygon-types menu", body: [ { kind: "li", text: "Go to Polygon Types on the top-right menu." }, { kind: "li-ui", text: "Tap the ", ref: { text: "Query", icon: "query" }, suffix: " button to view, edit, or delete existing types." } ]}, { kind: "h4", text: "Add a new area type" }, { kind: "step", n: "→", title: "Create the type", body: [ { kind: "li", text: "Go to Polygon Types on the top-right menu." }, { kind: "li-ui", text: "Tap ", ref: { text: "Save Location", icon: "save" }, suffix: "." }, { kind: "li", text: "Enter the area type and tap Save." } ]}, { kind: "h4", text: "Add a sub-type" }, { kind: "step", n: "→", title: "Create the sub-type", body: [ { kind: "li", text: "Select the parent type. Go to Polygon Types on the top-right menu." }, { kind: "li-ui", text: "Tap ", ref: { text: "Save Location", icon: "save" }, suffix: "." }, { kind: "li", text: "Define Polygon Subtype and layer name." }, { kind: "li", text: "Tap Save." } ]}, { kind: "callout", variant: "warn", title: "English letters only", body: "AutoCAD layer names must use English letters only." } ] } ]; window.SUPPORT_SECTIONS = SUPPORT_SECTIONS;