76 lines
2.0 KiB
Markdown
76 lines
2.0 KiB
Markdown
<p align="center">
|
|
<a href="" rel="nooperner">
|
|
<img width=200px height=200px src="public/logo.png" alt="Tailfin Logo"></a>
|
|
</p>
|
|
|
|
<h3 align="center">Tailfin</h3>
|
|
|
|
---
|
|
|
|
<p align="center">A self-hosted digital flight logbook</p>
|
|
|
|
## Table of Contents
|
|
|
|
- [About](#about)
|
|
- [Getting Started](#getting_started)
|
|
- [Configuration](#configuration)
|
|
- [Configuration](#configuration)
|
|
- [Usage](#usage)
|
|
- [Roadmap](#roadmap)
|
|
|
|
## About <a name="about"></a>
|
|
|
|
Tailfin is a digital flight logbook designed to be hosted on a personal server, computer, or cloud solution. This is the
|
|
web frontend.
|
|
|
|
I created this because I was disappointed with the options available for digital logbooks. The one provided by
|
|
ForeFlight is likely most commonly used, but my proclivity towards self-hosting drove me to seek out another solution.
|
|
Since I could not find any ready-made self-hosted logbooks, I decided to make my own.
|
|
|
|
## Getting Started <a name="getting_started"></a>
|
|
|
|
### Prerequisites
|
|
|
|
- npm
|
|
- [tailfin-api](https://github.com/azpsen/tailfin-api)
|
|
|
|
### Installation
|
|
|
|
1. Clone the repo
|
|
|
|
```
|
|
$ git clone https://git.github.com/azpsen/tailfin-web.git
|
|
$ cd tailfin-web
|
|
```
|
|
|
|
3. Install NPM requirements
|
|
|
|
```
|
|
$ npm install
|
|
```
|
|
|
|
5. Build and run the web app
|
|
|
|
```
|
|
$ npm run build && npm run start
|
|
```
|
|
|
|
## Configuration <a name="configuration"></a>
|
|
|
|
The URL for the Tailfin API can be set with the environment variable `TAILFIN_API_URL`. It defaults to `http://localhost:8081`, which assumes the API runs on the same machine and uses the default port.
|
|
|
|
## Usage <a name="usage"></a>
|
|
|
|
Once running, the web app can be accessed at `localhost:3000`
|
|
|
|
## Roadmap <a name="roadmap"></a>
|
|
|
|
- [x] Basic API sessions and data fetching
|
|
- [x] Functionality for adding flights
|
|
- [ ] Dashboard with statistics
|
|
- [ ] Calendar view
|
|
- [ ] Attach photos to log entries
|
|
- [ ] Admin dashboard to manage all users and server configuration
|
|
- [ ] Integrate database of airports and waypoints that can be queried to find nearest
|
|
- [ ] GPS track recording and map display
|