Exin

Exin is a web app that shows currency exchange changes and lets you work with multiple currency pairs at the same time.
For each pair, you can also enter multiple amounts in parallel to compare conversions quickly.

This is a simple app built to test the possibilities of lovable.dev.

Table of Contents

• Try It
• Features
• Tech Stack
• Getting Started
• Project Structure
• Notes
• Contributing
• License

Try It

Use the live app here: https://exin.lovable.app

Features

• Multi-pair workflow with tab-based navigation.
• Multiple amount rows per pair (auto-add rows while typing).
• Two-way conversion editing (from -> to and to -> from).
• Live exchange rate fetching from @fawazahmed0/currency-api (CDN) with a fallback endpoint.
• Historical chart data from dated API snapshots with selectable periods (1W, 1M, 1Y).
• Currency search and pair selection modal.
• PWA setup with service worker registration.

Tech Stack

Based on the source code, Exin is built with:

• Frontend framework: React 18 + TypeScript
• Build tool: Vite 5 (@vitejs/plugin-react-swc)
• Routing: React Router (react-router-dom)
• Data fetching/cache: TanStack Query (@tanstack/react-query)
• Styling: Tailwind CSS + tailwindcss-animate
• UI primitives: Radix UI components + shadcn/ui-style component structure
• Charts: Recharts
• Icons: Lucide React
• PWA: vite-plugin-pwa + virtual:pwa-register
• Linting: ESLint + TypeScript ESLint
• Testing: Vitest + Testing Library + JSDOM
• Package managers used in repo: npm and Bun lockfiles are present

Getting Started

Local Development

Prerequisites

• Node.js 18+ (recommended)
• npm (or Bun)

Installation

npm install

Or with Bun:

bun install

Run in Development

npm run dev

Build for Production

npm run build

Preview Production Build

npm run preview

Lint and Test

npm run lint
npm run test

Docker Deployment

This repository includes Docker deployment files in the docker/ folder:

Note: docker/deploy-exin.bat is intended for a remote server running Alpine Linux with Docker already installed.

• docker/Dockerfile: multi-stage image that:
  • downloads the project source from GitHub,
  • installs dependencies and builds the app,
  • serves the built app with Nginx (SPA fallback included).
• docker/deploy-exin.bat: Windows batch script that:
  • asks for SSH host and user,
  • connects to your Linux VM over SSH,
  • escalates with su to run all deployment steps as superuser,
  • downloads only the Dockerfile,
  • builds/updates the image,
  • recreates the container,
  • opens the app URL in your browser.

Run it from the project root:

docker\deploy-exin.bat

Optional: pass host and user directly.

docker\deploy-exin.bat <SSH host IP> <SSH user>

Project Structure

docker/             Dockerfile and Windows deployment script
src/
  components/      UI and feature components (tabs, selector, table, chart)
  hooks/           Data/query hooks
  pages/           Route pages
  services/        API integration (`@fawazahmed0/currency-api` + fallback)
  data/            Currency catalog and related types

Notes

• Exchange rates are requested from https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api with fallback to https://currency-api.pages.dev.
• Historical chart data is fetched from dated snapshots and sampled to keep requests manageable.
• The app currently focuses on a compact, fast experimentation flow.

Contributing

Contributions are welcome. If you want to improve Exin, open an issue or submit a pull request with a clear description of the change.

License

This project is licensed under the MIT License.