A fast, reliable Progressive Web App (PWA) for currency conversion with real-time exchange rates.
- 🌍 150+ Currencies - Support for major world currencies
- ⚡ Real-time Rates - Live exchange rate updates
- 📱 PWA Support - Install as an app on any device
- 🎨 Modern UI - Clean, responsive design
- 🔍 Smart Search - Quick currency lookup
- 🌙 Dark Theme - Eye-friendly dark mode
- 📱 Mobile First - Optimized for mobile devices
- React 19 - Latest React with concurrent features
- Vite - Fast build tool and dev server
- PWA - Offline support and installable
- Vercel - Deployment and hosting
- Node.js 16+
- npm or yarn
- Clone the repository:
git clone https://github.com/Kbassem10/ImhotepCurrency.git
cd ImhotepCurrency- Install dependencies:
npm install- Create environment file:
cp .env.example .env- Add your API key to
.env:
VITE_EXCHANGE_API_KEY_PRIMARY=your-api-key-here- Start development server:
npm run dev- Connect to GitHub: Connect your repository to Vercel
- Environment Variables: Add your environment variables in Vercel dashboard
- Deploy: Vercel will automatically deploy on every push to main branch
npm run build
npm run preview| Variable | Description | Required |
|---|---|---|
VITE_EXCHANGE_API_KEY_PRIMARY |
Exchange rates API key | Yes |
- Install Prompt - Can be installed on devices
- Meta Tags - Comprehensive SEO meta tags
- Open Graph - Social media previews
- Structured Data - JSON-LD for search engines
- Sitemap - XML sitemap for crawlers
- Robots.txt - Search engine directives
The app integrates with the Imhotep Exchange Rates API:
- Base URL:
https://imhotepexchangeratesapi.pythonanywhere.com - Endpoint:
/convert/latest_rates/{api_key}/{from}/{to}/{amount} - Response Format: JSON with conversion data and metadata
- Fork the repository
- Create a feature branch:
git checkout -b feature/new-feature - Commit changes:
git commit -m 'Add new feature' - Push to branch:
git push origin feature/new-feature - Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Website: https://imhotepcc.vercel.app
- Email: [email protected]
- GitHub: https://github.com/Kbassem10/ImhotepCurrency
- Exchange Rates API - Imhotep Exchange Rates API
- Icons - Font Awesome
- Hosting - Vercel
Made with ❤️ by Imhotep Tech