## π± 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
> β οΈ **Scope**: This tool is for existing Giffgaff or Simyo subscribers only. It supports eSIM device changes and physical SIM to eSIM conversion β not new number registration. To get a new eSIM, Giffgaff users can obtain the QR code via third-party modified APK/modules and scan it directly; Simyo users should use the official app.
---
## π 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)
---
## β¨ 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
### 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 processing is performed locally
- β
No user credentials stored
- β
Open source and transparent, code is auditable
- β
Recommended to use in a secure network environment
---
## π οΈ 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 run dev
# 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)
- [Notification System Guide](./docs/guides/notification-system.md)
- [Security Guide](./docs/SECURITY.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 [Notification System Guide](./docs/guides/notification-system.md) and [Security Guide](./docs/SECURITY.md)
---
## π€ 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
---
## Code of Conduct
This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
## π License
- All code in this project, unless otherwise stated, is released under the [MIT License](LICENSE).
- README.md, wiki, and other resources in this project are licensed under [CC BY-NC-SA 4.0][CC-NC-SA-4.0]. This means you may copy and redistribute project content,
but you must also **provide original author attribution and license notice**. At the same time, you **may not use this project for commercial purposes** under our narrow interpretation
(additional clause): any **profit-generating activity is considered commercial use**.
- Please use this project in compliance with local laws and regulations.
## βοΈ Disclaimer
This tool is for learning and personal use only. Please comply with the relevant terms of service. The developer is not responsible for any issues caused by using this tool. Please use it in accordance with local laws and regulations.
[github-hosts]: https://raw.githubusercontent.com/racaljk/hosts/master/hosts "hosts on Github"
[CC-NC-SA-4.0]: https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh
---
