• Surmai
• Features
• Rationale
• Mobile Apps
• Screenshots / Screencasts
• Demo
• Installation
• One-Click Deploy
• Credits
  • PocketBase
  • Mantine
  • Translations
  • Icon
  • Data
• Possibly FAQ

Surmai

Surmai is a personal/family travel organizer. The app is built to solve 3 particular challenges while planning a trip:

1. Allow collaborative planning between multiple people.
2. Allow easy access to all the necessary artifacts during the course of the trip.
3. Keep the data private.

NOTE: This is a very very alpha stage project and under active development. Please report any issues using Github Issues.

Features

• Organize a trip in one place
• Allow collaboration between multiple users
• Offline access
• Privacy
• Mobile friendly

Rationale

As avid travellers, we (me & SO) split up the planning tasks e.g. booking plane tickets and making dinner reservations etc, with the receipts / confirmation emails being in our own respective inboxes. These emails were tagged but were not necessarily organized chronologically. It was also a huge pain to find the right email at the right time, especially given some low bandwidth connections.

I've been a Backend software engineer for the last ~20 years. My last professional interaction with Javascript was pre jQuery days when Internet Explorer 5 demanded we test the navigator every time something was to be written. I have been exposed to the "new" Javascript at my current job as a necessity and decided to use this project as a learning opportunity.

Mobile Apps

Surmai is built as a Progressive Web App. It's possible to install it as a regular app on mobile phones. Installation Instructions

Screenshots / Screencasts

Can be seen at http://surmai.app/documentation/screenshots

Demo

A demo is available at https://demo.surmai.app/

Demo Account:

Email: [email protected]

Password: vi#c8Euuf16idhbG

Feel free to create an account and explore.

NOTE: The demo site is cleaned up every hour.

Installation

Installation guide with Docker and a potential backup solution can be found in the documentation http://surmai.app/documentation/installation

One-Click Deploy

Credits

PocketBase

Surmai uses PocketBase as it's backend platform. The API is great and the documentation is first-class. The PocketBase Admin UI also allows for configuration that is not available from within Surmai (yet).

Mantine

Surmai is a React based SPA built using the absolutely phenomenal library Mantine. Vite for building and prettier for formatting.

Translations

Surmai uses react-i18next for localization and Weblate for translation. Translations are available in multiple languages and can be easily contributed to through Hosted Weblate.

Contribute translations here: https://hosted.weblate.org/projects/surmai/frontend/

Icon

Fish SVG Vector

Data

Airports

From OurAirports

Cities

From countries-states-cities-database

Airlines

From dotmarn/Airlines

Currency Conversion

From ExchangeRate-APIs open acces endpoint

Possibly FAQ

Why so ugly tho?

~20 years as a backend dev, I have a tendency to lean towards function over form.

Why not use ${other_thing}?

I wanted to learn React/Typescript, that's about it. So many side projects have languished because I gave up when it came to building the UI. I wanted this one to be different.