How to install the app and use it offline

The Shamsi ⇄ Miladi converter is a Progressive Web App (PWA). That means you can add it to your phone or computer like an ordinary app, and once you have visited it once, it keeps working with no internet connection. All date conversion happens in your browser, so nothing is sent to a server even when you are offline.

Why install it?

• Works offline. After the first visit, the converter loads and runs with no network at all.
• One tap to open. An icon on your home screen or desktop saves you typing the address each time.
• Full-screen and fast. The app opens without the usual browser toolbars and starts almost instantly.
• Private by default. The converter itself collects no data and makes no network call to convert a date.

Install on Android (Chrome)

1. Open the converter at the site address in Chrome.
2. You may see an Install app or Add to Home screen banner near the bottom. Tap it.
3. If no banner appears, tap the three-dot menu (top right) and choose Install app or Add to Home screen.
4. Confirm. The icon appears in your app drawer and home screen.

Install on desktop (Chrome or Edge)

1. Open the converter in Chrome or Microsoft Edge.
2. Look for a small install icon in the address bar (often a monitor with a downward arrow, or a plus).
3. Click it and choose Install. In Edge you can also use the three-dot menu → Apps → Install this site as an app.
4. The app opens in its own window and is added to your Start menu, Dock or Applications, depending on your system.

Add to Home Screen on iPhone and iPad (Safari)

iPhone and iPad do not show an automatic install button, so you add the app manually through Safari:

1. Open the converter in Safari (this does not work from the in-app browser inside other apps).
2. Tap the Share button (the square with an upward arrow) at the bottom or top of the screen.
3. Scroll down and tap Add to Home Screen.
4. Edit the name if you wish, then tap Add. The icon appears on your home screen and opens like a normal app.

Using it offline

The first time you open the converter, your browser quietly caches the small set of files it needs to run. After that, the app will load even with no signal — on a plane, on the underground, or anywhere the connection drops. Because every conversion is done locally with the proven jalaali-js arithmetic and cross-checked against your browser's own Persian calendar, the result is exactly the same online or off.

To get an update later, simply open the app while you are back online; the latest version is fetched in the background for next time.

If you do not want to install

Installing is optional. You can always use the converter straight from your browser by visiting the page — bookmarking it works perfectly well too. Installing just makes it quicker to reach and reliable offline.

Keep exploring

Once you are set up, you might find these guides useful: Shamsi to Gregorian, Gregorian to Shamsi, the Persian months, and common conversion mistakes. For how your data is handled, see the privacy page.