Help & Support
You can use Xiaorili without signing in, or sign in by email to sync business trips, important dates and notes between your own iOS and Android devices. Settings sync is also available from Android 1.3 and iOS 1.3. This page covers common tasks, data sources and troubleshooting.
Getting started
The iOS app is available through the App Store for iPhone and iPad, requires iOS / iPadOS 17 or later, and supports Chinese and English from version 1.2. The Android app is not distributed through app stores; download its APK only at xiaorili.aistella.net. Email accounts, sync and in-app update checks are available on Android from version 1.3, and from version 1.4 reminders, travel statistics, the footprint and other features match iOS. Calendar, Weather and More are the three main tabs.
On iPad, the month calendar and records appear side by side when the window size allows. Long record lists scroll within their panel. Smaller windows and larger accessibility text sizes use a layout suited to reading.
- Select a date in “Calendar” to see its lunar date, solar term, week number, holidays and records. Use the month arrows to navigate, or return to today.
- In “More”, open the list of all records to add a business trip or important date. Tap an existing record to edit it. Deletion requires confirmation.
- In “More → Locations & Public Holidays”, choose weather cities and preferred holiday countries or states. A fresh installation has no preset cities or regions. You can also add a city directly from the empty weather view.
- In “Weather”, view current conditions and a six-day forecast including today for cities you selected. City search requires a network connection, and results include administrative areas and countries for you to check.
Reminders and local tools (iOS 1.3 and Android 1.4 or later)
In “More → Reminders”, enable important date, trip, anniversary milestone or solar term reminders. All are off by default, and the first enable requires system notification permission. Milestones use the important date reminder time on the milestone day. Solar terms use the calendar’s civil date, with an adjustable default time of 8:00, rather than the astronomical instant. Unknown years receive no milestone reminders; for lunar dates, first add the starting lunar year in “Milestones & Birthday Details”. Missed reminder times are not sent later. Tapping a notification opens its date.
The device generates reminders from the current guest or account’s records without uploading additional data for reminders. It schedules up to the nearest 60 notifications and reschedules when you open or return to the app or change records, supplementary years or reminder settings. If a reminder does not arrive, check the app’s switches, system notification permission and Focus settings. More distant reminders are scheduled on later app visits.
“More” also offers travel statistics, a leave planner, milestones and birthday details, and solar term cards. Travel statistics, leave plans, milestones and birthday details are calculated on the device; the leave planner uses cached or bundled mainland China holiday and adjusted workday schedules (from version 1.4 it can also use another country or region, retrieving its public holiday data when needed), and solar term content comes with the app. Almanac and solar term content is for folk culture reference only. Reminder preferences, supplementary starting years and unknown-year settings for milestones stay on this device, outside exported JSON backups and account sync; set them again on another device. Existing records still follow their usual backup and sync rules, and local data may be included in iPhone/iCloud system backups. Copying a statistics summary or leave plan writes it to the system clipboard. Deleting an account also removes its supplementary starting-year details from this device.
From version 1.4, “More → Business Travel Statistics → Footprint Map & Stats” shows a dot map and statistics with a year switcher, and “Create Year in Travel Card” turns a year’s footprint into an image you can share, with an option to hide cities. The map marks only cities with known coordinates: trips entered manually in early versions without a linked city do not appear until you edit the trip and use “Find & link a city”. The mainland China rule “No make-up workdays (statutory holidays only)” is in “More → Locations & holidays → Optional rules · China mainland”. It is off by default, stays on this device and is not synced. Arrangements vary by employer; follow your company’s notice.
Why a date may not appear
Gregorian February 29 appears only in leap years. Annual lunar dates use the regular month and skip leap months. If a month has no day 30, the date is not moved to day 29. A one-time event uses a complete Gregorian date.
Mainland China shows official holidays and published adjusted workday arrangements. Malaysia supports 13 states and 3 federal territories. “Nationwide holidays” includes only entries applying to all 16 regions; selecting it does not mean there are no additional state-specific holidays.
Hong Kong uses the government’s 1823 public holiday data, showing actual holidays and announced substitute dates as published in the Gazette. For example, in 2026 it shows October 19 as “The day following Chung Yeung Festival”, rather than treating the festival’s October 18 date as that gazetted holiday. The source currently covers 2025–2027 and follows official updates thereafter; see the official dataset for coverage. It is not a list of all traditional festivals.
Other supported countries use Nager Community, showing holiday dates without actual substitute or observed dates. Follow local announcements for days off. Austria supports 9 states. For other supported countries, this version includes only entries marked nationwide by the source and may not cover local state or employer arrangements. US entries should not be treated as a complete OPM federal employee leave schedule or a list of every state’s days off.
The calendar combines preferred holiday regions with destination regions selected for business trips in the current month and updates those regions online. Company compensatory leave for Kedah is a custom arrangement, marked separately from public holidays and off by default. You can enable it in “Locations & Public Holidays”. It applies only to Kedah, Malaysia, and does not replace your employer’s actual arrangements. Holidays may change; follow official announcements. The almanac and I Ching are for entertainment and cultural reference only, not a basis for decision-making. Health-related content cannot replace medical advice, diagnosis or treatment. If you have a health concern, seek medical care promptly.
Weather or holiday updates fail
Forecasts come from Open-Meteo. City search is provided by Open-Meteo, with place name data from GeoNames. You select cities manually. Neither iOS nor Android requests device location permission, and both use the same requests for weather, holidays and city search. Forecasts can change; consider local weather alerts when planning travel.
From iOS 1.3 and Android 1.4, when displaying saved weather cities or cities linked to trips, Xiaorili may query Open-Meteo using the city ID and app language if no usable name is cached. The ID can indicate a city you selected, and the provider also receives ordinary network information such as your IP address. Requests do not include trip dates, notes, important dates or account credentials. Names are cached on the device, excluded from account sync and exported JSON backups; if a query fails, saved names are used.
Editing records does not require a network connection. Weather and public holiday updates do. If an update fails, existing caches are retained and the app shows the update time or unavailable data. There is no cache before weather is first retrieved, so the app does not invent an offline forecast. Check your connection, then refresh the page in the app.
“Data unavailable” means there is no available data for the current region or year, rather than that there are no holidays. Years outside the Hong Kong official source’s coverage are also shown as unavailable; the app does not calculate substitute holidays itself. Retrieving Hong Kong official data for the first time requires a connection. Built-in holiday data covers only some years for mainland China and Kedah, not other states or countries. The app distinguishes built-in, cached and online data.
Backing up and restoring records
- First export a JSON backup from “More” and save it somewhere you can access.
- On another device, or when restoring, select a compatible version 1 backup file. The app checks its format, dates, types and duplicate IDs first.
- Check the record counts and current identity in the replacement prompt, then confirm. Restoring replaces the current guest’s or account’s records. Records imported while signed in can sync to the account’s other devices.
Version 1 JSON backups contain only business trips, important dates and notes. They exclude weather cities, preferred holiday regions and company compensatory leave preferences, and restoring records does not replace those settings. From Android 1.3 and iOS 1.3, these settings sync after sign-in and are stored per account. In guest mode or while signed out, they stay on the device. I Ching casting history is stored in the app’s local data. It is not synced to an account or included in version 1 JSON backup files exported by the app. On iOS, it may be included in iPhone/iCloud system backups. On Android, it is excluded from system backups.
Invalid files or failed saves do not overwrite current records. Backups contain private records; check the recipient before sharing. If the app reports that records cannot be read, preserve existing files or backups and contact support rather than repeatedly overwriting the original data.
Email sign-in and cross-device sync
Account sync is available from iOS 1.0 and Android 1.3. Settings sync is available from iOS 1.3 and Android 1.3. To move between iOS and Android, sign in with the same email account and sync, or export and restore a compatible version 1 JSON backup on the other device. Backup-based migration excludes settings and I Ching casting history.
You can use the calendar, edit records and make manual JSON backups without signing in; guest records stay on the device. For cross-device use, sign in with an email verification code in “More → Account & Sync”, then sync now. The first successful verification of a new email address creates a separate account. Sign in with the same email address and sync on another device to see the account’s business trips, important dates and notes. Versions supporting settings sync also sync weather cities, holiday regions and the company compensatory leave toggle. Account records and guest records are kept separately. Signing in for the first time does not automatically import guest trips, important dates or notes. Only if the account has never saved cloud settings and its local account settings are at their defaults are guest weather cities, holiday regions and the company rest day toggle copied into the account and synced automatically.
Account details, records and settings in supported versions sync to the developer’s own cloud service (Tencent Cloud servers in Guangzhou, mainland China) at calendar-api.aistella.net and are stored per account.
To migrate existing local data, choose the option to import local guest records, confirm and sync. If a conflict occurs, read the prompt first and export a backup if needed, then explicitly choose to keep local records or use the entire cloud record set. Choosing a whole set affects all records in the account, so check carefully.
Signing out returns you to guest data; other accounts’ records and location preferences are not mixed in. To delete an account, go to the account deletion area in “More → Account & Sync”, request a new code at your current email address, enter it, choose to delete the account and cloud records, then confirm. Successful cloud deletion removes both the account’s cloud records and settings (weather cities, holiday regions and the company compensatory leave toggle). Local cleanup includes the account’s records, those settings and weather cache. If cleanup fails, follow the app’s instructions. Damaged recovery copies that cannot be clearly attributed may remain and require uninstallation or manual cleanup. External JSON backups and separate guest data must also be managed separately.
Deleting a live account does not immediately erase existing database backups. The server backs up daily and removes backups with file modification times more than 7 days old during its daily task; operational failures may delay this. For retention, third-party services and local copies, see the Privacy Notice. Contact support if account deletion cannot be completed in the app.
Verification code limits and security verification
Resending to the same email address requires at least 60 seconds between requests, with default limits of 6 emails per hour and 10 per day. Six-digit codes are valid for 10 minutes and allow at most five incorrect attempts. Request a new code after expiry. Email addresses, network IPs and the service as a whole also have sending limits. If a rate limit appears, do not repeatedly tap; waiting one minute may not reset an hourly, daily or total allowance.
Verification emails are sent through Tencent Cloud SES in Hong Kong from noreply@mail.aistella.net. From version 1.3, the app requests Chinese or English verification emails according to its interface language. Until English emails are enabled, all verification emails are sent in Chinese. The security verification page is available in English from version 1.3. If an email does not arrive, check the address and your spam folder, wait for the resend interval and try again. Avoid repeated requests, and do not send verification codes to support staff.
Before requesting a code, complete Cloudflare Turnstile security verification in the app to reduce abuse such as bulk email sending. Verification processes security signals including IP, browser and system information, and verification interactions. See security verification privacy details. If verification does not complete, check your connection and follow the page’s instructions to try again.
Android downloads, installation and update checks
Download the Android APK from xiaorili.aistella.net. For the initial installation from the website, allow “Install unknown apps” for the app used to download or open the package, then confirm installation yourself. Get and update the iOS app through the App Store.
From Android 1.3, opening or returning to the app requests version information from https://xiaorili.aistella.net/download/android.json at most once every 12 hours. This sends no personal data, but the site receives ordinary network information such as your IP address. The website server only keeps daily totals of homepage visits, installer downloads and update checks (each device counted once per day) to understand usage; these statistics do not store IP addresses, and the temporary data used for de-duplication is deleted the next day. Update packages come from the same site and are checked for SHA-256 and signature before installation. The first time you use in-app updates, you must allow “Install unknown apps” for Xiaorili; after that, tap “Update” in the app. On Android 12 and later, some system versions may complete installation directly without another system confirmation prompt. On Android 11 and earlier, the system asks you to confirm each update installation.
If checking or downloading fails, check your connection and try again, or download from the website above. If validation fails, download again from that site; do not install a package that fails validation.
Users in the EU/EEA (GDPR)
The data controller is the app’s individual developer, Felix Wang. Contact: mywy8866@gmail.com. Full data categories, purposes and third-party processing are described in the Privacy Notice’s GDPR section and the earlier sections it references.
- Legal bases and providers: processing necessary for accounts, sync, account deletion and other features you request is based on performance of a contract. Turnstile verification, rate limiting and abuse prevention are based on legitimate interests in protecting accounts and the service. We do not carry out marketing or user profiling. Providers include Tencent Cloud (servers in Guangzhou, mainland China, and SES emails in Hong Kong), Cloudflare (security verification) and Open-Meteo (weather and place name queries, receiving selected city coordinates, city IDs, language and ordinary network information; active city searches also send search text). See network details for holiday requests and other data flows.
- International transfers and choice: your synced email address, records and account settings are stored on Tencent Cloud servers in Guangzhou, mainland China, outside the EU/EEA; access from outside mainland China is relayed unchanged through the developer’s Hong Kong server, which does not decrypt or store this data. You can stay signed out to keep records and settings on your device and use JSON backups. Online features such as weather and holidays still send the request data described above.
- Retention: live account details, records and settings are kept while the account exists and removed after successful account deletion. After each successful business backup task, files with modification times more than 7 days old are removed; failures may delay cleanup. The separate deletion audit, its exports and recovery copies of rate-limit digest counters currently have no automatic expiry or cleanup and are outside that 7-day rule. See retention details.
- Your rights: where applicable, request access, rectification, erasure, data export or portability, restriction of processing, object to processing based on legitimate interests, and withdraw consent where relevant, without affecting the lawfulness of processing based on consent before withdrawal. You may also complain to the data protection supervisory authority in your country.
- Actions and response: view and edit records in the app; deleting online records requires a successful sync. For account deletion, go to “More → Account & sync → Delete account & cloud records”; see email sign-in and sync for the steps. JSON backups in “More” export business trips, important dates and notes; see backup and restore for scope and limitations. Email the contact above for other data exports, rights requests or actions you cannot complete in the app. We will respond within one month of receiving your request.
Contact support
Individual developer: Felix Wang. Support email: mywy8866@gmail.com. Page address: Help & Support.
When reporting an issue, include your device model, operating system version, app version, affected page, steps to reproduce and error message. Hide real birthdays, business trips and notes in screenshots and examples. A complete private backup is usually unnecessary.