← Dashboard ⬇ Download Guide

1. System Overview

HangarHub Mx is KP Aviation’s maintenance management system. It runs in your web browser — no app to install.

DashboardMain control panel — aircraft queue, status updates, work orders, messaging, timekeeping, quoting
Work OrderFull-page work order editor — discrepancies, labor tracking, parts, AD compliance, sign-off
AD ComplianceAirworthiness directive tracking per aircraft and work order
AMTS PortalCustomer-facing status and messaging portal
💡 Always use Google Chrome or Microsoft Edge. Safari on iPhone has a known login issue that is being addressed.
Dashboard URLkpaviationservices.com/mechanic-dashboard.html
AMTS Portal URLkpaviationservices.com/customer-portal.html
Shop phone(208) 557-3709
SMS number+1 (208) 980-2553 (Twilio)

2. Creating a Mechanic Account

Create via Admin Panel (recommended)

  1. Log in as an admin and click ⚙ Admin in the topbar.
  2. Click the 👤 Accounts tab.
  3. Fill in username, display name, password, and confirm password.
  4. Check Grant admin access if needed.
  5. Click Create account.
✅ Passwords must be at least 10 characters.

Reset a Password

node src/manage-users.js reset <username> "<new_password>"
⚠ Passwords cannot be looked up. If forgotten, reset via the Render Shell command above.

3. Logging In

  1. Navigate to the dashboard URL.
  2. Enter your username and password.
  3. Press Enter or click Sign In.
  4. Session stays active until you sign out.
✅ Bookmark the dashboard URL for quick access from any device.
⚠ Do not share login credentials. Each mechanic must have their own account.

4. The Dashboard

Topbar

✈ HangarHub MxShop logo
Clock widgetLive timer, Clock In/Out/Break, Timesheet, My Hours (apprentices only)
⚙ AdminAdmin panel — admin accounts only
✈ Savvy AviationOpens Savvy portal in new tab
❓ HelpOpens this guide
Sign OutLogs you out

Adding an Aircraft

  1. Click + Add Aircraft.
  2. Type the N-number and press Tab — auto-fills make, model, year, serial, engine, owner name, address from FAA registry.
  3. Fill in owner cell phone, service type, assigned mechanic, estimated completion.
  4. Click Add & Send Welcome SMS.
💡 A message ticket is created automatically on check-in. Customer messaging is available immediately.

Status Update

  1. Click Update on the aircraft row.
  2. Select status: Pending / In Progress / Waiting on Parts / Complete / Grounded.
  3. Select the current stage.
  4. Enter a customer note (sent in SMS and AMTS portal).
  5. Enter a shop note if needed — internal only.
  6. Update estimated completion if changed.
  7. Toggle Send SMS — defaults to OFF.
  8. Click Send update.
⚠ When status is set to Complete, a 24-hour pickup reminder SMS sends automatically the next day.

5. Work Order — Full Page

Opens in a new tab when you click the WO button on any aircraft row.

Labor Hours — Two Options Per Discrepancy

Manual entryType hours directly into the Labor Hrs field (e.g. 2.5). Updates the total immediately.
▶ Start timerClick ▶ Start to begin automatic timing. Live counter updates the field in real time.
⏸ Pause timerClick ⏸ Pause to stop. Hours written into the field. Manual edits always allowed.
💡 Only one timer runs at a time. Starting a new one pauses any other running timer.

Parts Entry — Multiple Parts Per Discrepancy

  • Type a part name or number in the Parts / Costs field — autocomplete searches your inventory.
  • Click a result to insert it. The part fills in with description and cost.
  • Press Enter to start a new line, then type the next part name to add additional parts.
  • You can also type free-text descriptions for items not in inventory.
✅ Each part goes on its own line. The autocomplete only searches the current line you are typing on.

Saving

  • Click 💾 Save (green pulsing button, top right).
  • Autosave runs every 60 seconds silently.
⚠ Always save before closing. Do not rely on autosave exclusively.

Topbar Buttons

← DashboardReturns to the dashboard
💾 SaveSaves all work order data
⚖ AD Compliance ↗Opens AD compliance for this work order
💬 MSGOpens customer message thread
🖨 PrintPrints work order with QR code and sign-off block

6. Customer Messaging System

Every aircraft has a message ticket automatically created at check-in.

  1. Open the work order and click 💬 MSG.
  2. Type your message and click Send, or attach a photo with 📎 Photo.
  3. Check Internal to send a note visible only to mechanics.
✅ Press Ctrl+Enter to send quickly.
Red ! on WO buttonUnread customer message. Clears when you open the thread.
Slide-in toastPops up when a new message arrives.

Customers visit kpaviationservices.com/customer-portal.html, enter their phone number, and see status plus the full message thread.

7. AD Compliance

Open from the work order topbar: ⚖ AD Compliance ↗

⚠ Save the work order at least once before opening AD Compliance.
StatusOpen / ✅ Complied / ➖ N/A / ⏳ Deferred
RecurringCheck if repetitive compliance required
Method of ComplianceHow the AD was complied with
Date / HoursDate and aircraft hours when complied
Next DueWhen next action required (recurring ADs)
Internal NotesShop notes — not printed on customer copy
  • 💾 Save saves all AD data.
  • 🖨 Print AD List generates a printable 14 CFR Part 39 compliance report.

8. SMS Notification System

HangarHub sends SMS from +1 (208) 980-2553.

Welcome SMSSent automatically when aircraft is added
Status Update SMSSent when you update status — defaults to OFF
24-Hour Pickup ReminderSent automatically the day after status is set to Complete
✅ Use plain English in customer notes. Avoid jargon.

9. Manual Library (HangarHub)

Click the 📚 Manuals button on the dashboard to open the HangarHub manual browser overlay. Contains 619 built-in manuals plus any custom manuals added by an admin.

Aircraft tabFilter by manufacturer and category (POH, Maintenance Manual, Parts Catalog, Wiring Diagram)
Engines tabFilter by manufacturer and manual type (Lycoming, Continental, Rotax, etc.)
Components tabFilter by component type and brand (avionics, props, magnetos, landing gear, etc.)
QRG tabFAR Part 43 and Quick Reference Guides
✅ All filter dropdowns work independently. Select a manufacturer to show only their manuals, then narrow further by category.

Relevant Manuals on Work Orders

When you open a work order, the Relevant Manuals section auto-matches the aircraft make/model and engine. Click Show ▼ to expand. Results grouped by ✈ Airframe, 🔧 Engine, ⚙ Component.

Adding Custom Manuals (Admin)

Admin Panel → 📚 Manuals tab → + Add manual → fill in title, manufacturer, model, category, type, and URL. Custom manuals appear automatically in work order Relevant Manuals.

10. QR Code System

  • QR code printed on every work order — links to the AMTS customer portal.
  • Customer scans QR → enters phone number → sees status AND message thread.
  • QR scanner in dashboard — scan to jump to that aircraft’s update panel.

11. Employee Timekeeping

The time clock lives in the topbar — always visible after login.

Clock In / Out / Break

Clock InClick Clock In when you arrive. Live timer starts immediately.
Start BreakClick Start Break. Timer pauses; break time deducted.
End BreakClick End Break when returning. Timer resumes.
Clock OutClick Clock Out and confirm. Total hours calculated automatically.
💡 The live timer persists if you close and reopen the browser.

My Timesheet

  1. Click Timesheet in the topbar.
  2. View Mon–Sun breakdown: clock in/out, break minutes, daily hours.
  3. Summary shows Regular (up to 40 hrs), Overtime, and Total.
  4. Click ⬇ Download PDF to print for signing.
  5. Use ◄ Prev / Next ► to view other weeks.
✅ A week shows Approved once the manager approves it in the Admin Panel.
⚠ Timekeeping hours are for payroll only. Separate from work order labor hours.

Manual Time Entry (Admin)

  1. Admin Panel → ⏱ Timekeeping → click + Add Entry.
  2. Select employee, date, clock in time, clock out time, break minutes, and optional note.
  3. Live preview shows calculated hours.
  4. Click Save Entry.
💡 Use this for missed punches or entries from prior weeks.

12. Apprentice Tracker

FAA-compliant apprentice hour log for mechanics working toward their A&P certificate under 14 CFR Part 65.

💡 The My Hours button only appears for accounts flagged as apprentice by an admin.

Hour Targets

Airframe (A) only2,880 hours
Powerplant (P) only2,880 hours
Airframe & Powerplant (A&P)4,800 hours

Logging an Entry

  1. Click My Hours in the topbar.
  2. Click + Log Entry.
  3. Fill in: Date, N-Number, Aircraft Type, ATA Chapter, Hours, Task Description.
  4. Click Save Entry.
✅ Filter your log by ATA chapter using the dropdown.

Verification and Locking

Pending ⏳Entry is editable and deletable by the apprentice
Verified ✅Entry is locked — apprentice cannot edit or delete. Admin can unlock.
⚠ Once verified, an entry is locked for FAA log integrity. Contact your supervising mechanic if a correction is needed.

Experience Letter PDF

  1. Click ⬇ Experience Letter in the My Hours modal.
  2. PDF shows: name, program dates, verified hour totals, progress bar, full entry table, and signature lines.
  3. Print and present to supervising mechanic for signature.
💡 Only verified entries count toward FAA totals on the experience letter.

13. Admin Panel

Click ⚙ Admin in the topbar. Only visible to admin accounts.

📦 Parts Inventory Tab

  • Search and filter by name or stock level (In Stock / Low / Out).
  • Click any field to edit inline — a Save button appears on that row. Click it to commit the change.
  • Use the Set button to update quantity on hand.
  • + Add part — part number, description, cost, qty, min qty, location.
  • 虹 Import CSV — accepts QuickBooks export. Filters out service/labor items automatically.
  • 蚁 Export CSV — downloads full parts list.
✅ Parts below minimum show yellow. Parts at zero show red. Changes do NOT auto-save — always click Save on the row.

👤 Accounts Tab

  • Create accounts with username, display name, and password.
  • Toggle Admin checkbox to grant or revoke admin access.
  • Delete accounts with the Delete button.

📉 Display Tab

  • Enable/disable screens, set duration, reorder with arrows.
  • Built-in screens: Shop Status Board, KIDA Weather, Flight Tracker.
  • Add custom URL screens. Set background color, accent, font, and transition.
  • Click 💾 Save Display Config — shop display updates within 30 seconds.

💰 Rates & Fees Tab

Set your shop labor rates and fees. These are used automatically when creating new quotes.

Pistons @ KIDADefault $130/hr
Pistons — MobileDefault $135/hr
Turboprops @ KIDADefault $145/hr
Turboprops — MobileDefault $150/hr
Turbine Jets & Helicopters @ KIDADefault $165/hr
Turbine Jets & Helicopters — MobileDefault $170/hr
Mileage RateDefault $1.50/mile — applied to travel jobs
Emergency Call Out FeeDefault $250 flat fee
  • Edit any value and click 💾 Save Rates.
  • Changes apply to all new quotes immediately. Existing saved quotes are not affected.
  • Rates auto-fill on new quotes based on detected aircraft type and whether it is a travel job.
✅ Always click Save Rates after making changes — there is no auto-save on this tab.

📚 Manuals Tab

  • Shows the full 619-manual built-in library merged with your custom manuals.
  • Filter by manufacturer or category using the dropdowns.
  • + Add manual — title, manufacturer, model, category, type, URL. Appears automatically in work order Relevant Manuals.
  • Built-in manuals show a Built-in label. Custom manuals show an X delete button.

⏱ Timekeeping Tab

  • View all employees’ time entries for any week using Prev / Next.
  • LIVE badge shows anyone currently clocked in.
  • Edit — correct clock in/out, break minutes, or notes on any entry.
  • Del — permanently delete an entry.
  • ✅ Approve Week — marks the week as approved.
  • + Add Entry — manually add a time entry for any employee for any date.
  • 蚁 Export All PDFs — prints all employee timesheets for the selected week.
⚠ Deleting a time entry is permanent.

✍ Apprentice Tab

  • Lists all mechanic accounts with total hour progress at a glance.
  • Expand any account to configure: supervising mechanic, A&P cert number, program start date, and Certificate Pursuing (A / P / A&P).
  • Check Mark as apprentice to enable the My Hours button for that account.
  • Click Load Entries to see all log entries in a scrollable list.
  • Filter entries by All / Verified / Pending using the dropdown.
  • Verify — locks an entry permanently.
  • Unlock — removes verification if a correction is needed.
  • Edit — modify any entry (admin can edit even verified entries).
  • + Add Entry — add an entry on behalf of the apprentice.
  • 蚁 Experience Letter — generates a print-ready FAA experience letter.

📋 Quotes Tab

Create, manage, and send maintenance estimates to customers. Admin-only.

Creating a Quote

  1. Click + New Quote.
  2. Enter the N-number and press Tab — auto-fills aircraft and owner info from the FAA registry.
  3. Select the service type — the system checks past completed work orders and shows historical labor averages for that service + aircraft combination.
  4. Adjust Est. Hours and Rate ($/hr) (default $130/hr).
  5. Toggle Travel job to add a travel fee line.
  6. Search your parts inventory to add line items, or click + Custom line for items not in inventory.
  7. Add optional notes (printed on the quote).
  8. Click 💾 Save Quote.
✅ The live totals box updates as you type: labor + travel + parts + 6% sales tax on parts = estimated total.

Quote Status Flow

⬜ DraftBeing built, not yet sent
📤 SentEmailed to customer, awaiting response
✅ AcceptedCustomer approved
❌ DeclinedCustomer passed
⏰ ExpiredPast validity date (auto after 10 days)
🔄 ConvertedTurned into a work order

Sending and Managing

  • 📄 PDF — generates a print-ready estimate with KP Aviation branding and signature lines.
  • 📧 Send — emails the estimate directly to the customer’s email address on the quote.
  • Accept / Decline — mark the customer’s response.
  • ⇄ WO — converts an accepted quote to a work order in one click. Pre-fills the aircraft, customer info, and service type automatically.
💡 Email sending requires EMAIL_USER and EMAIL_PASS environment variables configured on the server. Without them, quotes still mark as Sent but the email won’t go out.

14. Archiving Aircraft

  1. Open the work order for the completed aircraft.
  2. Click Archive in the update panel → Confirm.
  3. Aircraft removed from queue. All data preserved permanently.

Restoring

  1. Dashboard → Archive panel → ↩ Restore.
💡 Archiving does not delete work orders, time records, AD data, or message threads.

15. Savvy Aviation

Click ✈ Savvy Aviation in the topbar to open apps.savvyaviation.com in a new tab.

16. Quick Reference — Common Tasks

Create mechanic accountAdmin Panel → 👤 Accounts → fill form → Create account
Reset a passwordRender Shell → node src/manage-users.js reset <user> "<pass>"
Add a new aircraftDashboard → + Add Aircraft → N-number → Tab → fill fields → Add & Send Welcome SMS
Update aircraft statusDashboard → Update → status + stage + note → Send update
Open a work orderDashboard → WO button
Enter labor hours manuallyWork Order → type hours into the Labor Hrs field
Time a discrepancyWork Order → discrepancy row → ▶ Start → ⏸ Pause when done
Add multiple partsWork Order → Parts field → type part → select from autocomplete → Enter for next line
Send customer a messageWork Order → 💬 MSG → type → Send
Save a work orderWork Order → 💾 Save (green, top right)
Open AD complianceWork Order → ⚖ AD Compliance ↗
Print work orderWork Order → 🖨 Print
Clock inTopbar → Clock In
Clock outTopbar → Clock Out → Confirm
View my timesheetTopbar → Timesheet
Add manual time entry (admin)Admin Panel → ⏱ Timekeeping → + Add Entry
Approve employee week (admin)Admin Panel → ⏱ Timekeeping → expand employee → Approve Week
View my apprentice hoursTopbar → My Hours (apprentice accounts only)
Log an apprentice entryMy Hours → + Log Entry → fill all fields → Save Entry
Generate experience letterMy Hours → ⬇ Experience Letter
Verify an apprentice entry (admin)Admin Panel → ✍ Apprentice → expand → Load Entries → Verify
Enable apprentice mode (admin)Admin Panel → ✍ Apprentice → expand → Mark as apprentice → Save Profile
Update shop rates (admin)Admin Panel → 💰 Rates & Fees → edit values → Save Rates
Create a new quote (admin)Admin Panel → 📋 Quotes → + New Quote → fill form → Save Quote
Send a quote to customer (admin)Admin Panel → 📋 Quotes → 📧 Send on the quote row
Convert accepted quote to WO (admin)Admin Panel → 📋 Quotes → ⇄ WO button on accepted quote
Preview / print quote PDF (admin)Admin Panel → 📋 Quotes → PDF button on quote row
Archive a completed aircraftWork Order → Archive → Confirm
Add a custom manual (admin)Admin Panel → 📚 Manuals → + Add manual
Import parts from QuickBooks (admin)Admin Panel → 📦 Parts → 虹 Import CSV
Save a part price change (admin)Admin Panel → 📦 Parts → edit inline → click Save on the row
Configure shop display (admin)Admin Panel → 📉 Display → configure → Save Display Config
Sign outDashboard → Sign Out (top right)

17. System Information

Dashboard URLkpaviationservices.com/mechanic-dashboard.html
Work Order URLkpaviationservices.com/work-order.html
AMTS Portal URLkpaviationservices.com/customer-portal.html
AD Compliance URLkpaviationservices.com/ad-compliance.html
Help URLkpaviationservices.com/help.html
Backendkp-aviation-backend.onrender.com
SMS number+1 (208) 980-2553 (Twilio)
Image storageCloudinary (dqykqykh4)
Shop emailkpaviationmx@gmail.com
Shop phone(208) 557-3709
Shop address1940 International Way, Idaho Falls, ID 83402

This system was built specifically for KP Aviation Services. For technical issues or new features, contact your system developer.