Trail Companion is a source-available web application designed to simplify loaning equipment during off-road events, club rides, training classes, and other group activities.
Instead of manually tracking who borrowed radios or recovery gear, organizers generate a QR code for each item. Borrowers scan the code, enter their name, and the checkout is immediately recorded. The organizer's screen automatically resets and is ready for the next borrower.
- 📱 QR code equipment checkout
- 👤 Mobile-friendly borrower interface
- ☁️ Azure Functions backend
- 💾 Azure Table Storage
- 🔄 Automatic organizer updates
- 📋 Equipment return/check-in
- 🌐 GitHub Pages frontend
- 📱 Responsive design for phones, tablets, and desktops
- Select a category
- Enter the equipment description
- Optionally enter an ID or inventory number
- Generate a QR code
- Scan the QR code
- Enter their name
- Submit the checkout
- Checkout is stored in Azure
- Organizer display automatically clears the QR
- Equipment becomes available in the Return screen
- Item can later be checked back in
- React
- Vite
- QRCode.react
- Azure Functions (Node.js)
- Azure Table Storage
- GitHub Pages
- Microsoft Azure
The organizer interface uses a private workspace ID and organizer access key. Each workspace is stored in its own Azure Table Storage partition, so organizers can only list or return loans from their assigned workspace.
Organizer keys are entered at runtime and are never stored in the source,
frontend build, or borrower QR. Borrower QR links use signed, expiring,
one-use checkout tokens. Active-loan responses are marked no-store.
Required Azure Functions application settings:
COMPANION_TENANTS— comma-separatedworkspace-id=sha256-key-hashentriesCOMPANION_SESSION_SECRET— a random secret of at least 32 charactersCOMPANION_ALLOWED_ORIGINS— comma-separated approved frontend originsCOMPANION_QR_TTL_MINUTES— optional QR lifetime from 1–60 minutes
Never commit organizer keys, the session secret, or local.settings.json.
Current development focuses on creating a simple, reliable checkout system before expanding into inventory management and event features.
Implemented:
- ✅ QR checkout workflow
- ✅ Azure synchronization
- ✅ Automatic organizer refresh
- ✅ Equipment return/check-in
- ✅ Mobile-friendly interface
Planned:
- Event sessions
- Inventory management
- Checkout history
- Search and filtering
- Club customization
- Authentication
- Reporting
- Offline support
Suggestions, issues, and pull requests are welcome.
If you have ideas that would help volunteer organizations, off-road clubs, amateur radio groups, or other communities manage shared equipment, please open an issue.
This project is licensed under the PolyForm Noncommercial License 1.0.0. See the LICENSE file for the full terms.
In short: the source is available for anyone to view, learn from, and use for noncommercial purposes (personal projects, education, nonprofits, etc.). Commercial use — including running Trail Companion for a club, business, or organization, whether or not a fee is charged to members — is not covered by this license and requires a separate commercial license.
Interested in a branded deployment for your club (custom name, colors, and hosted setup)? Open an issue or reach out directly to discuss licensing.