Four things, described at their real size.
SwimScript is a practice planner, not a training platform. This page says what is in it, and says plainly where something is thinner than it sounds.
The parser
A practice is written, not filled in. SwimScript reads the line the way a swimmer reads it and turns it into repeats, distance, stroke, equipment, effort and a send-off — then leaves everything it did not recognise in the description, verbatim, rather than dropping it.
What it understands
- Multipliers, however you write them.
4 * 75,4 x 75,12*50with no spaces, and200 pullon its own as a single repeat. - Send-offs and rest.
@ 1:15,@ :30,on the 1:30,every 1:30, spelled-out intervals, an option list like@ :30/:40with every alternative kept, and rest written as@ :20 sr,R10sor a line of its own reading1 MR. - Compound rounds.
3 * (150- Str/Free x 25; desc.1-3 + 50 easy) @ 3:30is read as a round of two swims with a send-off on the round, not as one long string. - The bracket that never closes. In these documents
(introduces an instruction rather than enclosing one — 48 unclosed to 107 closed across the twelve reference practices — so a note that runs to the end of the line is read as a note.(o)and(e)stay odds and evens. - Equipment, in the words you use. Over forty spellings —
w/fins,zoomers,P&F,w/pb,drag sox,stretch cord— including a heading's equipment note applying to the sets under it, and(fins off)taking it back off again. - Effort and emphasis.
desc.1-3,↓,neg split,afap,build— and the bold and underline you put on25 FAST, which survive into the printed sheet because you meant them. - Your own arithmetic. Where a document has totals typed in, SwimScript compares them with what it works out and flags the difference. Three of the twelve reference practices disagree with themselves; one is out by a hundred yards.
- Shorthand it has never seen.
UWK,SWOLF,Mntn— unknown tokens are carried through to the sheet untouched rather than swallowed. The parser is built to degrade, not to reject: whatever it is given, it does not fail.
Where it stops
-or-stays as text. SwimScript knowsPull -or- Kickis a choice well enough not to price the equipment into an estimate, but there is no model of "the swimmer picks one".- Composition inside a repeat — the
x 25in150- Str/Free x 25— is kept in the description, not broken out. - Rounds do not nest more than one deep. Across twelve documents none does; that is an observation, not a guarantee.
- Course is set in the editor, not read from the practice.
The printed sheet
The sheet is the point. It gets taped to a whiteboard and read wet, from a metre away, so it has to look like the document the team already knows.
- Letter, portrait, 16pt. Measured from the source documents rather than chosen — 1,704 of 1,735 runs in the twelve practices are Times New Roman at 16pt, with 0.19in at the top and 0.5in at the sides.
- Metrically compatible type. The sheet is set in Tinos, which has the same advance widths as Times New Roman, so a line that fit your page fits ours and breaks in the same place. A merely similar serif would reflow the whole thing.
- Shrink to fit, with a floor. A long practice steps down from 16pt as far as 12pt to hold one page. All twelve reference practices fit on one side, at 14.1pt or larger. A practice that still overruns at the floor gets a second page — two legible pages beat one unreadable one.
- A real preview. The preview and the paper are driven by the same rules, so they cannot drift apart, and the header tells you the size it settled on.
- What it authored prints; what it derived does not. Your headings, notes,
emphasis and totals go on the page. Energy-zone labels and pace estimates stay off it: no
coach in the reference set writes
EN2on a practice, and putting the tool's vocabulary on the sheet would make it somebody else's document.
Reading the practices you already have
Drag a Word practice onto the page and it is opened, unzipped, read and counted by code running on your own machine. The file is not uploaded. That is not a policy, it is where the code runs — and it means the fastest way to find out whether SwimScript handles your notation is to try it on your own document, before there is an account involved.
.docxonly. A.doc, an RTF or a Google Docs export gets a message telling you to resave rather than a shrug.- Up to a hundred files in one go, and a drop of twenty where one is a PDF previews the other nineteen.
- You see what was understood — sections, sets, totals, disagreements — before anything saves.
- You can paste a practice instead, or start from an empty one.
- There is no export back to Word. There is a plain-text copy of the practice in the parser's own notation, and an account export of everything you have written as Markdown and JSON.
Teams
A team workspace holds one squad's practices and shows them to its members and to nobody else. Every practice, section and set carries the workspace it belongs to, tied to its parent by the database's own keys rather than by a query that has to remember — so a practice cannot be read out of the wrong team even if a request asks for it by name. Members are viewers, coaches or admins, and the switcher moves you between the teams you belong to and your own personal workspace.
Team administration is not built yet. There is no invite button, no member list and no way to create a team from inside the application; a team is set up by hand today, and its members appear when they first sign in. Pushing a practice from your own workspace into a team's is designed and not written. If you want a team workspace, ask — but know that today it is a conversation rather than a button.
Your account, and getting out of it
- Try it first. Three practices, kept in your own browser, with no account and nothing sent anywhere. Make an account later and they move across with you.
- Export everything. A zip of Markdown and JSON — one file per practice, in notation that pastes straight back in.
- Delete the account yourself, with thirty days to change your mind before the data goes.
- Installable. SwimScript runs in the browser and can be installed to a phone or tablet home screen. It is not a native app and there is nothing in an app store.
Not in it
Said here so you do not have to find out later: no roster, attendance or swimmer records. No deck timer or run mode. No shared links — nothing you write is public. No Word export. No analytics or trackers of any kind. No pricing, because it has not been decided.
The duration estimate deserves its own line. It is honest arithmetic over a model, and the model currently uses a single built-in pace for anything you did not give a send-off; there is no screen yet for telling SwimScript how fast your squad actually swims. Against the twelve reference practices the estimates span roughly 73 to 84 minutes for sessions the coach runs in about 75 to 80. Treat it as a sanity check on a set you just changed, not as a clock.