CurrencyXpress

CurrencyXpress is a modern web application that allows users to convert amounts between various currencies with real-time exchange rates. It also provides a history of past conversions.

✨ Features

• Real-time currency conversion.
• Support for a wide range of currencies.
• Display of conversion history.
• User-friendly interface.
• Responsive design for use on multiple devices.

🛠️ Technologies Used

• Frontend:
  • React with Vite
  • TypeScript
  • Shadcn UI - Beautifully designed components.
  • Tailwind CSS - Utility-first CSS framework.
  • React Router DOM - For client-side routing.
  • TanStack Query - For server state management and data fetching.
  • React Hook Form & Zod - For form handling and validation.
• Backend Integration:
  • Supabase - Open source Firebase alternative for database and authentication (used for storing conversion history).
• Development Tools:
  • ESLint - For code linting.
  • npm - Package manager.

🚀 Getting Started

Prerequisites

• Node.js (v18 or later recommended)
• npm (comes with Node.js)
• A Supabase account and project (for storing conversion history).

Development Setup

1. Clone the repository:

   git clone <YOUR_GIT_URL>
   cd <YOUR_PROJECT_NAME>

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root of the project. Add your Supabase project URL and Anon Key:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_PUBLISHABLE_KEY=your_supabase_anon_key

   You can find these in your Supabase project settings.

4. Run the development server:

   npm run dev

   This will start the Vite development server, typically at http://localhost:5173.

Available Scripts

• npm run dev: Starts the development server.
• npm run build: Builds the application for production.
• npm run lint: Lints the codebase using ESLint.
• npm run preview: Serves the production build locally for preview.

🖼️ Screenshots

CurrencyXpress - Full Page
Screenshot 2
Universal Currency Converter	Recent Conversions

🚢 Deployment

This project is built with Vite, which produces a static build in the dist/ directory.

1. Build the application:

   npm run build

2. Deploy the dist folder: You can deploy the contents of the dist folder to any static hosting provider, such as:

   • Vercel
   • Netlify
   • GitHub Pages
   • AWS S3, Google Firebase Hosting, etc.

   Most providers can be connected directly to your Git repository for automatic deployments on push.

🤝 Contributing

Contributions are welcome! If you'd like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature-name).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature/your-feature-name).
6. Open a Pull Request.

Please make sure your code adheres to the project's linting rules (npm run lint).

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

---