USER GUIDE • v1.2.0

Koh Lipe Instructor Earnings Calculator

How to record daily activities, allocate course commissions over several days, and track monthly earnings.

Applies to calculator v1.2.0 • English • Amounts in Thai baht (THB)

← Back to Calculator

🇧🇬 Bulgarian user guide: Прочетете инструкциите на български

1. What this calculator does

Enter your diving activity and sales figures for any date. The calculator estimates the commission allocated to that day, automatically spreads Open Water and Advanced Open Water course pay over multiple calendar days, and shows your monthly earnings.

The V5 edition is a Progressive Web App (PWA). Publish the provided files on an HTTPS website (such as GitHub Pages), then open the website in Safari on iPhone or Chrome on Android. After the first successful online visit and offline cache installation, the app can be used offline. Records remain local to the installed app/browser.

Important: This is an earnings-planning tool, not an employer payroll system. Earnings allocated to a day are not necessarily paid on that date.

2. Commission rates

ActivityCommissionWhat to enter
Double Tank (2 dives)฿400 per clientNumber of clients on two-dive trip
Afternoon Dive฿200 per clientNumber of afternoon-dive clients
Refresher / ReActivateRate pendingNumber of clients; commission excluded until configured
Night DiveRate pendingNumber of clients; commission excluded until configured
Open Water Diver (digital)฿3,200 per studentNumber of NEW students on course start date (3 days)
Advanced Open Water≈฿2,650 per studentNumber of NEW students on course start date (2 days)
DSD standard (2 dives)฿1,000 per participantNumber of participants
DSD 3rd dive (extra)฿500 per participant (assumed)Participants with optional 3rd dive
Personal sales5% of sales value (assumed additional)Total personal sales in THB

*The extra ฿500 is treated as an instructor commission, and the 5% sales commission is treated as additional to dive/course earnings. Confirm both details with the dive centre.

3. How to enter and save a day's work

  1. Open the published calculator website in Safari, Chrome, or a compatible browser. Look for the “Calculator active” message.
  2. Choose a date under Work date.
  3. Type your quantities directly or tap the + / − buttons beside each activity. For personal sales, the buttons change the sales value by ฿100; you can type any exact amount.
  4. Check Estimated earnings allocated to this day. This updates as you adjust the values, including any course commission continuing from an earlier date.
  5. Tap Save this day to store your entry and update the monthly totals.

The daily estimate changes as you type. The Monthly overview reflects saved entries, so remember to save.

Example: recreational divers

Two certified divers each complete two dives. Enter 4 recreational tanks, not 2 customers. Commission: 4 × ฿200 = ฿800.

4. Multi-day courses: enter students only once

Open Water Diver (OWD) — 3 calendar days

OWD pays ฿3,200 per student. When two students start on November 18, enter 2 OWD students on November 18 only. The total course commission is ฿6,400, allocated equally over November 18, 19 and 20.

DateDaily allocated OWD commission
November 18≈฿2,133.33
November 19≈฿2,133.33
November 20≈฿2,133.33
Total (unrounded)฿6,400.00

Do not enter these same two students again on the 19th or 20th. Their continuing earnings appear automatically, even if you do not save a separate entry for those dates.

Advanced Open Water (AOWD) — 2 calendar days

One AOWD student pays approximately ฿2,650 in instructor commission. If the student starts on November 18, the calculator allocates ฿1,325 on November 18 and ฿1,325 on November 19.

Courses spanning two months

A course starting on November 30 can allocate part of its commission to December automatically. Use View month to see the correct amount in each month.

Scheduling assumption: Course pay is spread across consecutive calendar days, including rest days if they fall in the middle. The calculator does not currently allow skipping a rest day or separately scheduling individual course sessions.

5. DSD and extra third dives

The standard DSD activity is two dives. Enter the number of participants in DSD – standard, 2 dives. If any of those participants also choose a third dive, enter that number in DSD – additional 3rd dive.

Example: Two DSD participants complete two dives and one of them completes a third. Enter DSD = 2 and 3rd dive = 1. The estimated instructor commission is ฿2,500 (฿2,000 + ฿500).

The app warns if the third-dive count exceeds the standard DSD participant count, but may allow you to save after confirmation.

6. Personal sales commission

Enter the monetary sales value, not the count of items or customers. For example, sales of ฿10,000 produce a ฿500 commission at 5%.

If you sell a course you also teach, include that course's selling price in personal sales only if the dive centre confirms the 5% is payable in addition to your teaching commission. The calculator does not automatically detect or remove duplicate sales credit.

7. Monthly overview and history

8. Editing, clearing and deleting

9. Export, backups and changing phones

Data is stored locally in the specific browser/device where you used the calculator. It is not synchronized between iPhone and Android. To transfer it, export a JSON backup from the first phone and restore it on the other.

iPhone Files preview does not reliably run this HTML. Do not open index.html from Files: visit the published HTTPS link in Safari instead. If the buttons do nothing, or you see “JavaScript is not running”, verify you are on the hosted web page. Test one dummy entry and verify it remains after reopening. Keep JSON backups: clearing browser data or changing how you open the file may make earlier records inaccessible.

10. Quick worked example

On one date, you take 2 clients on Double Tank, 1 on Afternoon Dive, start 2 new OWD students, guide 1 standard DSD participant and make ฿4,000 in personal sales. The dive commissions are ฿800 + ฿200, the OWD accrual for that first day is ฿2,133.33, DSD earns ฿1,000 and personal sales are ฿200 (assuming the extra 5% applies): total approximately ฿4,333.33 for that day.

ComponentCommission allocated today
2 Double Tank clients฿800.00
2 new OWD students — first of 3 days≈฿2,133.33
1 standard DSD฿1,000.00
5% of ฿4,000 personal sales฿200.00
Estimated daily allocation≈฿4,333.33

The two OWD students also generate approximately ฿2,133.33 on each of the next two calendar days without being entered again. The course's full commission is still ฿6,400.

11. Publish updates using GitHub Pages

  1. Sign in to GitHub and create a new repository, for example koh-lipe-earnings. For standard GitHub Pages on a Free account, choose Public.
  2. Extract koh_lipe_pwa_v5.zip on a computer. Upload all files from inside the extracted folder into the root of the repository: index.html, manifest.webmanifest, sw.js, the PNG icons, user-guide.html, and .nojekyll. Do not upload the ZIP alone.
  3. Open the repository Settings → Pages. Under Build and deployment, choose Deploy from a branch, select main and /(root), then Save.
  4. Visit the URL GitHub Pages provides, normally https://YOUR-USERNAME.github.io/koh-lipe-earnings/. Wait for deployment to complete if the site is not available yet.
  5. Confirm the message Calculator active and test the + button before installing it.

Privacy: The source code is public when published in a public repository. Do not place real client names or other private information in GitHub. Calculator records are only held in local device storage and are not uploaded to GitHub by this app.

12. Install on iPhone and Android

iPhone / iPad

  1. Open the GitHub Pages URL in Safari.
  2. Tap Share (square with upward arrow).
  3. Choose Add to Home Screen; turn on Open as Web App if shown.
  4. Tap Add. Open Lipe Earnings from your Home Screen.

Android

  1. Open the published URL in Chrome.
  2. Open the menu (three dots) and choose Install app or Add to Home screen.
  3. Confirm, then open the new app icon.

Offline use and updates

Open the published page while connected to the internet once to allow the app resources to be cached. Test in airplane mode after the page has loaded. For future updates, replace the GitHub files, then reopen the app with an internet connection to fetch the new version. Because installed apps can use separate storage from browser tabs, make a JSON backup before changing installation methods or removing/reinstalling the app.

On some devices, storage restrictions, low storage, browser data clearing, or app removal can erase saved records. There is no cloud sync. Export JSON backups regularly.

13. Version notes and future updates

Prior versions V1–V5 were informal milestones. The V5 PWA is the 1.0.0 SemVer baseline; the current updated release is 1.2.0. Use MAJOR.MINOR.PATCH for future releases.

This guide is designed to be revised together with future calculator releases. When an activity, rate, calculation rule or feature changes, update the corresponding instructions and the version notes rather than relying on an older guide.

What’s new in version 1.2.0

Use the language selector at the top of the calculator to choose English, Spanish, French, Portuguese, German or Bulgarian. No additional calculator HTML files are required: text is translated in the browser while records remain unchanged.

Daily dive categories

To configure a pending rate later, open app.js and change refresher: null or night: null to the confirmed THB amount per participant. Commit the changes and increment the app version/cache version.

Previously saved recreational tanks

Older entries containing the original “Recreational dive tanks” field are kept as Legacy recreational tanks at ฿200 per tank. They remain in historical totals and backups; when editing an old saved day, the legacy value is preserved. Enter new Double Tank and Afternoon Dive clients in the new separate fields.

Dates and course allocations

OWD (digital only) pays ฿3,200 per student, split equally across 3 consecutive calendar days. AOWD pays approximately ฿2,650 per student, split across 2 days. Enter new students only on their course start date. DSD standard two dives pays ฿1,000 per participant; a third DSD dive is assumed to add ฿500 instructor commission per participant, subject to confirmation. Personal sales earn an additional 5% if the centre confirms this applies alongside teaching commission.

Saved data and backups

Save This Day writes to local storage on the current device. The app does not synchronize between Android and iPhone. Use Backup all data (JSON) before changing devices or reinstalling the app. The upgrade maintains the previous local storage key to preserve existing entries.

GitHub Pages update steps

  1. In VS Code replace index.html and user-guide.html; add app.js; replace sw.js and README.md. Keep the icon and manifest files.
  2. Commit with a message such as feat: split dive activities and add five-language UI (v1.2.0).
  3. Push to the main branch, then open the published GitHub Pages URL and reload the installed app once online.

Version history

Historical V1–V5 labels were informal milestones, not SemVer releases. From this release onward, use MAJOR.MINOR.PATCH. Version 1.2.0 introduces new activity categories and localization without changing the old saved-data format. Version 1.0.0 represents the existing installable V5 app baseline. Older revisions: V1 original calculator; V2/V3 mobile controls and fixes; V4 OWD/AOWD multi-day allocation; V5 installable PWA with offline support.

Version 1.2.0 — Bulgarian language

The calculator now includes Bulgarian (Български) as a sixth interface language. The Instructions link automatically opens the Bulgarian guide when Bulgarian is selected, and the English guide for other interface languages. Existing records, rates and course allocation logic are unchanged. Update app.js, index.html, both guides and sw.js together.

The PWA continues to store data locally; keep regular JSON backups. Version 1.1.1 was a clean-up release; version 1.2.0 adds localization.