https://github.com/theassettrack/driving-logbook
Tax-compliant trip reporting web application with Wialon GPS integration
https://github.com/theassettrack/driving-logbook
fleet-management gps-tracking pwa react tailwindcss tanstack typescript vitest wialon
Last synced: 3 months ago
JSON representation
Tax-compliant trip reporting web application with Wialon GPS integration
- Host: GitHub
- URL: https://github.com/theassettrack/driving-logbook
- Owner: theassettrack
- Created: 2025-07-07T10:26:56.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-07T11:32:37.000Z (3 months ago)
- Last Synced: 2025-07-07T11:37:25.130Z (3 months ago)
- Topics: fleet-management, gps-tracking, pwa, react, tailwindcss, tanstack, typescript, vitest, wialon
- Language: TypeScript
- Size: 440 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Driving Logbook
Tax-compliant trip reporting web application with Wialon GPS integration.
## 🚀 Features
- **Wialon Integration**: Seamless connection with Wialon GPS tracking platform
- **Trip Management**: View, filter, and categorize trips as business or personal
- **Saved Filters**: Save and quickly apply frequently used filter combinations
- **Multi-language**: Full support for English and Swedish (i18n)
- **Bulk Operations**: Select and update multiple trips at once
- **Advanced Table**: Virtual scrolling for 10,000+ trips with sorting and search
- **Data Export**: Export trips to CSV/XLSX formats
- **Mobile Responsive**: Optimized for all device sizes
- **PWA Support**: Progressive Web App with offline capabilities
- **Dark Mode**: Built-in theme switching
## 🛠️ Tech Stack
- **Frontend**: React 19, TypeScript, TanStack (Query, Router, Table)
- **Styling**: Tailwind CSS v4, Radix UI
- **Build**: Vite, Turborepo
- **Testing**: Vitest (337 tests, 100% passing)
- **Backend**: Bun, Hono (minimal API server)
## 📋 Prerequisites
- [Bun](https://bun.sh) v1.0+
- [Node.js](https://nodejs.org) v18+ (for some tooling)
- Wialon account with API access
## 🚀 Quick Start
1. Clone the repository:
```bash
git clone https://github.com/theassettrack/driving-logbook.git
cd driving-logbook
```
2. Install dependencies:
```bash
bun install
```
3. Start development server:
```bash
bun dev
```
4. Open http://localhost:3001 in your browser
## 🧪 Testing
Run all tests:
```bash
bun test
```
Run tests in watch mode:
```bash
bun test:watch
```
## 📦 Building
Build for production:
```bash
bun run build
```
## 🔧 Configuration
### Wialon Setup
1. Get your Wialon access token from [hosting.wialon.com](https://hosting.wialon.com)
2. Enter the token in the login screen
3. Select your fleet units and date range
### Environment Variables
Create a `.env` file in the root (optional):
```env
VITE_WIALON_HOST=https://hst-api.wialon.com
```
## 📱 Progressive Web App
The app can be installed as a PWA for offline access:
- Chrome/Edge: Click install icon in address bar
- Safari iOS: Share → Add to Home Screen
## 🤝 Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License.
## 🙏 Acknowledgments
- [Wialon](https://wialon.com) for GPS tracking platform
- [TanStack](https://tanstack.com) for amazing React tools
- [Radix UI](https://radix-ui.com) for accessible components