VesnaLessons

Turn family promises into scheduling rules

Before running a search, separate a promised time from a preferred arrangement. Use this checklist with the fictional six-student example.

1. A time is already promised

   Keep Noah’s Monday 16:00–16:30 lesson fixed. A successful search should preserve that commitment.

   Check the fixed-slot example

2. Siblings need consecutive lessons

   Use the back-to-back rule for Emma and Liam and check that both availability windows allow the pair. Two individually available slots are not enough if they cannot be consecutive.

   Review the setup steps

3. The search has finished

   Review Complete, Conflicts and Not placed, then inspect the actual family timetable before downloading its ICS. The example has six placed students and zero conflicts; that is a scheduling result, not a family acceptance or a sent invitation.

   Read calendar and delivery limits

Before you start

• Desktop Google Chrome.
• Families' availability as a CSV file, for example a Google Forms or Microsoft Forms response export or your own spreadsheet with a student name column and availability text such as “Mon 15:30-18:00; Wed 15:30-18:00”.

Keep your timetable safe while a file opens

CSV and saved-project reads pause editing, solving and export. Cancel keeps the current timetable and ignores the late file result. A clear error restores the controls so you can retry the same file.

1. 1

   Open, wait or cancel

   While a CSV or saved project is opening, the current timetable stays visible and editing and export wait. Use Cancel to keep working with your current timetable.

   

2. 2

   Review the file before continuing

   After a CSV opens, check the matched columns and preview before importing students. If a file cannot be read, your current timetable remains; correct the file and choose it again.

Chrome 152 on Linux and fictional lesson schedules were checked. Other platforms, real form exports, calendar imports and physical printing remain unverified. This remains the 0.1.x edition; desktop use is recommended.

Free 0.1.2 illustrated guide and fictional examples — application not included

Your first result

1. Buy, download and open

   Buy from /store/vesna-lessons/ and download vesna-lessons-0.1.2.zip from the checkout page. Extract it and open vesna-lessons/index.html in Chrome. The first time, it opens a fictional 32-student sample studio; press “Solve schedule” to see how it works. Later it opens your last project from the browser; use “Load sample data…” to see the samples again.

2. Set up your studio

   On the Studio tab enter Studio name, Teacher and “Lesson name in calendars”, the time display, the grid step for lesson start times, default lesson length and sibling default. Under “Teaching hours” tick your teaching days with From and To times, add Breaks, set the Rules (maximum continuous teaching, minimum break, travel time between sites) and list your Locations. Click “New” first if you want to start from an empty project instead of the sample settings.

3. Import families

   On the Import CSV tab click “Choose CSV file…” (or “Use pasted text”). In “2. Match the columns” check which column is “Student name(s)” (required), family, email, lesson length, location, availability, preferred times, fixed lesson time and siblings; columns with matching names are picked automatically. “3. Preview” lists every student with warnings. Choose the Import mode — “Replace all families and students (settings and locations stay)” or “Add to the current families” — and click “Import … students”, or “Discard”.

4. Check families

   On the Families tab review each family: lesson lengths, allowed locations, sibling rule (back-to-back, same day or independent), fixed lessons and availability. The email field is only written into files you export.

5. Solve and adjust

   On the Schedule tab choose a “Search limit” (Quick, Standard, Thorough or Custom) and click “Solve schedule”. The banner states the outcome: “Complete schedule”, “Not everyone fits” (with the reason), “No schedule possible with these fixed lessons”, “Search limit reached” or “Search cancelled”. Click or drag a lesson to move it, fix it or remove it; Conflicts and “Not placed” update immediately, and “Why not placed?” explains a missing student. Undo and Redo are next to Solve.

6. Export and share

   “Export CSV” downloads the schedule. “Calendar (.ics)” asks for “First day of term”, “Last day of term” and “Holidays / skipped dates”, then offers “Whole studio (your calendar)”, “One file per family (ZIP)” or one family; click Download. Each lesson becomes a weekly repeating event. “Print” opens Chrome's print dialog, where you can also choose Save as PDF. VesnaLessons never sends messages; share the files yourself.

7. Saving and backups

   Your project is saved automatically in this browser's local storage and reopens next time. Browser data can be cleared, so click “Save project” to download a .vesnalessons.json copy and “Open project” to load it again. The Help tab has a button to delete the data stored in this browser.

A worked example

Six fictional piano students in the sample studio

Input: examples/vesna-lessons/piano-studio-families.csv: 6 fictional students in 5 families (Family, Child, Minutes, Where, availability text, best times, a kept Monday 16:00 slot for one returning student, siblings together). It uses the sample studio's teaching hours and its “Home studio” location.

1. Open vesna-lessons/index.html in Chrome (if your own project opens, choose “Sample studio: 32 students, complete schedule exists” under “Load sample data…” first; save your project before that).
2. On Import CSV click “Choose CSV file…” and pick piano-studio-families.csv.
3. Check that the preview says “6 students in 5 families” and “No warnings.”, keep “Replace all families and students (settings and locations stay)” and click “Import 6 students”.
4. On Schedule keep “Standard: 2,000,000 steps” and click “Solve schedule”.
5. Click “Export CSV”; then “Calendar (.ics)” with term 2026-10-05 to 2026-12-18, skip 2026-10-26, “One file per family (ZIP)”, Download.

Expected result: The banner reads “Complete schedule: all 6 students placed”, Conflicts (0) and “Not placed (0)”. Monday: Noah Copperfield 16:00–16:30 (FIXED), Emma Ashgrove 16:30–17:00 and Liam Ashgrove 17:00–17:30 back-to-back; Tuesday: Sofia Brookfield 17:30–18:15; Wednesday: Oliver Elderby 16:00–16:30; Thursday: Mia Dunlin 17:30–18:30. The CSV has one row per lesson (Status, Day, Start, End, Minutes, Student, Family, Location, Fixed, …). The ZIP contains Ashgrove.ics, Brookfield.ics, Copperfield.ics, Dunlin.ics and Elderby.ics with weekly events until 18 December and 26 October skipped. File names start with the studio name, here “Vesna-Music-Studio-sample-data”, until you rename the studio on the Studio tab.

Troubleshooting

Compatibility & limits

• One teacher per project and one lesson per student per week; back-to-back sibling groups of up to five (use same day for larger families).
• Calendar times are floating local times without a time zone.
• Tested with Chrome 152 on Linux and synthetic data; real form exports, calendar-app imports, other browsers and physical printing are unverified.
• No Google Forms/Sheets connection, messaging to families or online calendar sync.

Need a hand?

Tell us the product, host application and version, what you tried, and the exact error. Contact support with a fictional example; keep private customer files and passwords out of your message.