## π± What is this?
**eSIM Tools** is a free online toolkit that helps **existing Giffgaff or Simyo subscribers**:
- π Convert physical SIM cards to eSIM (no card replacement needed)
- π² Quickly transfer eSIM when changing devices
- π· Generate eSIM QR codes for instant activation
> π‘ **Complete in 1-2 minutes**, no customer service contact needed, fully automated
---
## β¨ Who is this for?
### π¬π§ Giffgaff Users
β Have an existing Giffgaff number (UK carrier)
β Want to switch from physical SIM to eSIM
β Need to reactivate eSIM on a new device
β New users registering a number (must obtain number through official or third-party channels first)
### π³π± Simyo Users
β Have an existing Simyo number (Netherlands carrier, starting with 06)
β Need to change device or convert to eSIM
β New users registering a number (must register through official app first)
---
## π Quick Start
### Online Usage (Recommended)
**π Visit: [https://esim.cosr.eu.org](https://esim.cosr.eu.org)**
- β No installation needed, ready to use
- β Full feature support, regular updates
- β Offline support, local data processing
### Usage Flow
#### π¬π§ Giffgaff (Recommended: SMS Verification Activation)
1. **Login** - Choose secure login method
2. **Email/SMS Verification** - Enter the verification code received
3. **SMS Verification Activation** - Enter 6-digit SMS code
4. **Get QR Code** - Automatically generated, scan to activate
> π **Tutorial**: [Giffgaff User Guide](./docs/User_Guide_EN.md) (with video demo)
#### π³π± Simyo
1. **Account Login** - Enter phone number (starting with 06) and password
2. **Select Service** - Device change or retrieve existing eSIM
3. **Verification Code** - Enter SMS verification code
4. **Scan to Install** - Use the generated QR code on your new device
---
## πΌοΈ Interface Preview
Click to view screenshots
### Home
### Giffgaff eSIM Tool
### Simyo eSIM Tool
---
## β FAQ
### Giffgaff
Q: Which activation method is recommended?
**A**: "SMS Verification Activation" is recommended. Fully automated β just enter the SMS code and all steps complete automatically.
Q: How long does it take?
**A**: Usually 1-2 minutes. Send code β Enter code β Auto activation β Get QR code.
Q: Is manual activation still available?
**A**: No. Manual activation was officially disabled by Giffgaff on October 8, 2025. Please use SMS verification activation.
Q: What if I accidentally close the page?
**A**: After logging in again, the system resumes from recoverable points. It's recommended to keep the page open until activation completes.
Q: When can I activate?
**A**: Giffgaff service window is 04:30 - 21:30 UK time. Operations outside this window may fail. The UI shows local time vs UK time for reference.
Q: Which devices are supported?
**A**:
- **Apple**: iPhone XS/XR and newer, iPhone SE 2 and newer
- **Android**: Samsung Galaxy S20+, Google Pixel 3+, some OnePlus/Huawei models
- Check your device manual for detailed compatibility
### Simyo
Q: Which phone number formats are supported?
**A**: Only Dutch mobile numbers (10 digits starting with 06).
Q: What if I cannot receive the verification code?
**A**: You can choose the customer service verification option, or check your SMS blocking settings.
### Security & Privacy
Q: Is my data safe?
**A**:
- β All data is processed locally in your browser, not uploaded to servers
- β No passwords or sensitive information stored
- β Open source and transparent, code is auditable
- β Recommended to use in a secure network environment
---
## π New User Offers
If you don't have a number yet, register through these links to get bonus credit:
- **π³π± Simyo users**: New SIM activation gets [extra β¬5 credit](https://vriendendeal.simyo.nl/prepaid/AZzwPzb)
- **π¬π§ Giffgaff users**: New SIM activation gets [extra Β£5 credit](https://www.giffgaff.com/orders/affiliate/mowal44_1653194386268)
> β οΈ **Note**: This tool does not support new number registration. It only supports eSIM conversion and device changes for existing subscribers.
---
## π οΈ Local Deployment (Developers)
Click to view deployment instructions
### Quick Start
```bash
# 1. Clone repository
git clone https://github.com/Silentely/eSIM-Tools.git
cd eSIM-Tools
# 2. Install dependencies
npm install
# 3. Configure environment variables
cp env.example .env
# Edit .env to fill in required configuration
# 4. Start development server
npm start
# 5. Visit http://localhost:3000
```
### Requirements
- **Node.js** >= 18.0.0
- **npm** >= 8.0.0
- **Modern browser**: Chrome 88+, Firefox 85+, Safari 14+, Edge 88+
### Netlify Deployment
1. Fork this repository to your GitHub account
2. Connect the GitHub repository in [Netlify](https://app.netlify.com)
3. Build settings:
- Build command: `npm run build`
- Publish directory: `dist`
4. Configure environment variables (refer to `env.example`)
5. Deploy complete
---
## π Documentation
- **User Guides**
- [Giffgaff User Guide](./docs/User_Guide_EN.md) | [δΈζ](./docs/User_Guide.md)
- **Technical Reference** (Developers)
- [Architecture](./docs/ARCHITECTURE.md)
- [Giffgaff Technical Reference](./docs/reference/README_giffgaff_esim_EN.md) | [δΈζ](./docs/reference/README_giffgaff_esim.md)
- [Simyo Technical Reference](./docs/reference/README_simyo_esim_EN.md) | [δΈζ](./docs/reference/README_simyo_esim.md)
- [CORS Solutions](./docs/guides/CORS_SOLUTION.md)
---
## π§ Technical Features
- π **Minimalist Design** - Native JavaScript, no framework dependencies, small bundle size
- β‘ **Fast Response** - Global CDN acceleration, first contentful paint < 1.2s
- π **Privacy & Security** - All data processed locally, nothing uploaded to servers
- π¦ **Offline Ready** - Works offline, network fluctuations don't affect operations
- π― **Modern Standards** - PWA, Web Vitals optimized, mobile-friendly
> π» **Developer Documentation**: See [Technical Architecture](./docs/ARCHITECTURE.md) for implementation details
---
## π€ Contributing
Contributions and suggestions are welcome!
### How to Contribute
1. π΄ Fork the repository
2. πΏ Create a feature branch (`git checkout -b feature/AmazingFeature`)
3. πΎ Commit following the convention (`git commit -m 'β¨ feat(core): add QR code caching'`)
4. π€ Push your branch (`git push origin feature/AmazingFeature`)
5. π Open a Pull Request
### Commit Convention
```bash
# Format: (scope):
β¨ feat(auth): add automatic session renewal
π fix(simyo): fix verification code retry logic
π docs(readme): update installation instructions
```
**Available Commands**:
- `npm run hooks:install` - Install Git hooks
- `npm test` - Run tests
- `npm run quality-check` - Code quality checks
- `npm run security-check` - Security scan
---
## π Support & Feedback
If you encounter issues or have suggestions:
- π [Submit an Issue](https://github.com/Silentely/eSIM-Tools/issues)
- π View [Project Documentation](./docs/)
- π¬ Join community discussions
---
## π Star History
---
## π License
- **Code**: [MIT License](LICENSE)
- **Documentation**: [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)
- Free to copy and redistribute, but must **provide original author attribution** and **license notice**
- **Not for commercial use** (any profit-generating activity is considered commercial use)
---
## βοΈ Disclaimer
**This tool is for learning and personal use only**. Please comply with relevant terms of service. The developer is not responsible for any issues caused by using this tool. Please use in accordance with local laws and regulations.
---
