Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/santi020k/nomad-counter

Nomad Calculator is an essential tool for travelers and adventurers worldwide. This application, available in both Spanish and English, allows you to keep a precise record of your time spent in different countries, including days spent at airports during layovers or connections.
https://github.com/santi020k/nomad-counter

Last synced: 28 days ago
JSON representation

Nomad Calculator is an essential tool for travelers and adventurers worldwide. This application, available in both Spanish and English, allows you to keep a precise record of your time spent in different countries, including days spent at airports during layovers or connections.

Awesome Lists containing this project

README

        

# Nomad Counter

![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white)
![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge&logo=react&logoColor=%2361DAFB)
![Astro](https://img.shields.io/badge/Astro-0C1222?style=for-the-badge&logo=astro&logoColor=FDFDFE)
![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=for-the-badge&logo=supabase&logoColor=white)
![Zustand](https://img.shields.io/badge/zustand-%2320232a.svg?style=for-the-badge&logo=react&logoColor=%2361DAFB)
![Vercel](https://img.shields.io/badge/vercel-%23000000.svg?style=for-the-badge&logo=vercel&logoColor=white)
![Visual Studio Code](https://img.shields.io/badge/Visual%20Studio%20Code-0078d7.svg?style=for-the-badge&logo=visual-studio-code&logoColor=white)
![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)
![ESLint](https://img.shields.io/badge/ESLint-4B3263?style=for-the-badge&logo=eslint&logoColor=white)
![TailwindCSS](https://img.shields.io/badge/tailwindcss-%2338B2AC.svg?style=for-the-badge&logo=tailwind-css&logoColor=white)
![Zod Badge](https://img.shields.io/badge/Zod-3E67B1?style=for-the-badge&logo=zod&logoColor=white)

![Logo](./public/assets/logo.webp)

## Demo ([Production Website](https://nomad.santi020k.me/))

![App Screenshot](./public/assets/screenshot.png)

## Description

Nomad Counter is an essential tool for travelers and adventurers worldwide. This application, available in both Spanish and English, allows you to keep a precise record of your time spent in different countries, including days spent at airports during layovers or connections.

Have you ever wondered how many days you've spent exploring a country, even counting those unforgettable moments at airports? Nomad Counter provides you with the answer in a simple and efficient manner. Just input your travel details, including entry and exit dates for each country, as well as the details of international airport layovers.

Key Features of Nomad Counter:

- **Stay Calculator:** Log your travels country by country and get the total duration of your stays in each one, whether you're visiting or in transit at an airport.

- **Travel History:** Access a complete history of your past journeys, allowing you to track your adventures and reminisce about your experiences in each destination.

- **Bilingual Support:** The app is bilingual, with support in both Spanish and English to cater to a global audience of travelers.

- **Notifications and Reminders:** Set up reminders so you never forget to log your travels and make the most of Nomad Counter.

- **Travel Statistics:** Visualize statistics and charts summarizing your journeys in a clear and easy-to-understand format.

Whether you're a frequent traveler, an occasional adventure seeker, or a digital nomad, Nomad Counter will help you keep an accurate record of your days in different countries and airports.

This project has the potential to be a valuable tool for travelers worldwide, allowing them to keep a record of their travel experiences and providing useful data for future trips.

## Environment Variables

To run this project, you will need to add the following environment variables to your .env file

`PUBLIC_SUPABASE_URL`

`PUBLIC_SUPABASE_ANON_KEY`

## Run Locally

Clone the project

```bash
git clone https://link-to-project
```

Go to the project directory

```bash
cd nomad-counter
```

Install dependencies

```bash
npm install
```

Start the server

```bash
npm run dev
```

## Commands

All commands are run from the root of the project, from a terminal:

| Command | Action |
| :------------------------ | :----------------------------------------------- |
| `npm install` | Installs dependencies |
| `npm run dev` | Starts local dev server at `localhost:4321` |
| `npm run build` | Build your production site to `./dist/` |
| `npm run preview` | Preview your build locally, before deploying |
| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
| `npm run astro -- --help` | Get help using the Astro CLI |

## Running Tests (coming soon)

To run tests, run the following command

```bash
npm run test
```

## Deployment (coming soon)

To deploy this project run

```bash
npm run deploy
```

## Screenshots

![App Screenshot](./public/assets/screenshot.png)

## Tech Stack (Pending)

**Client:** React, zustand, TailwindCSS

**Server:** Supabase

## Color Reference

| Color | Hex |
| ----------------- | ------------------------------------------------------------------ |
| Primary | ![#471AA0](https://via.placeholder.com/10/471AA0?text=+) #471AA0 |
| Secondary | ![#B579E6](https://via.placeholder.com/10/B579E6?text=+) #B579E6 |
| Primary Dark | ![#b296d6](https://via.placeholder.com/10/b296d6?text=+) #b296d6 |
| Secondary Dark | ![#e2c8f6](https://via.placeholder.com/10/e2c8f6?text=+) #e2c8f6 |

## Features

- Light/dark mode toggle
- I18n
- Session with google

## Roadmap (coming soon)

- Additional browser support
- Add more integrations

## Feedback

If you have any feedback, please reach out to me at

## 🚀 About Me (coming soon)

Hi, I'm Santiago Molina! 👋

I'm a full stack developer...

## Authors

- [@santi020k](https://www.github.com/santi020k)

## 🔗 Links

[![portfolio](https://img.shields.io/badge/my_portfolio-000?style=for-the-badge&logo=ko-fi&logoColor=white)](https://santi020k.me/)
[![linkedin](https://img.shields.io/badge/linkedin-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/santi020k/)
[![twitter](https://img.shields.io/badge/twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://twitter.com/santi020k)

## Contributing (coming soon)

Contributions are always welcome!

See `contributing.md` for ways to get started.

Please adhere to this project's `code of conduct`.

## License

[MIT](https://choosealicense.com/licenses/mit/)