The PNG will follow. Meanwhile, I wrote an editor.
The story behind Telario and a practical guide to handoffs: the right file needs to arrive with a workable way to read it.

The message usually sounds reassuring: “I sent you the mockup.” The attachment exists, the filename looks plausible, and the deadline has been confirmed. Everything suggests that work can begin. Then you try to open it and discover a small gap in the handoff: the person who created the project has the software to read it. You mostly have an urgent need to understand what the project contains.
In my case, that software is Balsamiq. My boss uses it to sketch screens and flows. My job is to understand those sketches and turn them into implementation. I don’t have the licence available, and sometimes the image export is missing too. The document has arrived, but the information is still on the other side of a door. The door, naturally, does not respond to messages.
Telario started there. No grand theory about the future of wireframes: just a desire to stop asking for the same PNG. It is a personal project for opening .bmpr archives, displaying pages, making essential edits, and producing useful exports. The motivation is personal; the behaviour needs to be verifiable. That distinction keeps the story entertaining without turning it into a promise larger than the software.
1. An attachment is not yet a handoff
Sending a file transfers bytes. Handing work over makes the next step possible. Those actions are related, but they are not identical. A project archive can be correct, current, and complete for its author while remaining unusable to its recipient. A difference in tools, versions, or access can be enough. Completeness needs to be assessed from the side of the person beginning the next task.
A mockup communicates structure. If the developer must chase an export before understanding that structure, the communication is incomplete. The cost does not show up in the attachment size. It appears in messages, interrupted activities, uncertainty, and the difficulty of distinguishing a technical delay from an unresolved requirement. The folder contains everything except the moment when work can actually start.
The useful question is therefore bigger than “did you receive the file?”. Ask whether the recipient can open it, knows which revision matters, and can identify the page under discussion. Three small questions, each removing a different uncertainty. Without them, the project becomes a treasure hunt whose only map is the shared calendar. Receiving an attachment is easy to verify. Receiving enough context to work requires a little more care from both sides of the exchange.
2. The hidden cost of “I’ll send it later”
“Later” is an inexpensive word for the person saying it. For the person waiting, it may mean keeping a question alive in working memory: which screen, which detail, which control needed checking? When the image eventually arrives, some of the effort goes into reconstructing the question. Waiting time is only one cost. There is also the cost of returning to the task.
There is no need to dramatise every forgotten export. People forget things. The useful observation is whether the same problem keeps returning and whether progress always depends on one person being available. An occasional stumble is normal. A workflow that regularly stops at the same point deserves a small process improvement or a tool that reduces the dependency. Telario addresses the second possibility while leaving plenty of room for the first.
The simplest organisational solution remains excellent: send current images and a revision note with the editable project. Personal tools also exist for the days when the ideal process takes time off. On those days, I would like to read a screen without opening a diplomatic negotiation. If a small application gives me twenty minutes and a little independence, it already has a practical reason to exist. No mission statement involving industry disruption is required.
3. Reading a document and having a product licence
A document can legitimately be intended for someone who does not use the author’s software. That is common in collaborative work: designers, developers, and reviewers do not necessarily have identical tools. A useful handoff accounts for this asymmetry. It is not a competition to install the largest application collection, although some meetings seem determined to become one.
Telario works on the document you choose to open. It does not provide a Balsamiq licence, activate Balsamiq, or represent an official edition of that product. It independently interprets project data through its own renderer, with declared limitations. Access to content, use of an application, and distribution conditions for dependencies are different subjects. Each deserves its own accurate description rather than being bundled into a convenient slogan.
In a personal story, I can say, “I didn’t have the licence; I did have work to do.” In technical documentation, I must explain what actually happens: local opening, supported-control rendering, essential editing, and exports. The joke cannot become a guarantee that every file and every feature of the original editor will be reproduced perfectly. Good humour gets someone onto the page. Clear compatibility information helps them decide whether the software is appropriate for their work once they arrive.
4. Read first; decide about editing afterwards
The first useful outcome is understanding the document, not changing it. Seeing the page list, reading labels, and following element placement may unblock most of the task. Reading has a different risk profile from writing: it can provide information without introducing another archive revision into the team’s workflow.
That separation helps define a proportionate first test. Open the synthetic demo to learn the interface, then a real document containing at least one familiar page. Compare text, placement, and relationships. If the diagram is understandable, use it to prepare questions. If a control looks approximate, treat it as something to verify rather than permission to invent the missing specification. A visible result is evidence about a particular page, not about every future operation.
Only then consider edits. A local text correction prepared for discussion can be exported as an image without immediately becoming a new authoritative project archive. Saving .bmpr is a further step, and it remains experimental. Following that order prevents the excitement of a successful first opening from becoming an accidental certification of everything that could happen afterwards. It also gives the recipient a useful way to stop: sometimes reading the page is all the work requires.
5. A shared view is often the first useful deliverable
When discussion gets stuck on a document, a stable view can help: a screen everyone can open and point at. A PNG has a very simple advantage. Its recipient does not need to understand the project’s internal model. SVG adds vector graphics, but it still needs checking in the application or environment where it will be used.
An image does not contain all the author’s intentions. It does not automatically explain click behaviour, the represented state, or which element is provisional. Accompany it with a short context statement: page, revision, and purpose. “Login screen, Tuesday’s revision, reviewing the error message only” removes more ambiguity than a filename written entirely in capital letters. A clean image with no context can still be a remarkably efficient generator of incorrect assumptions.
Telario makes that view possible when an export is missing, within the limits of its renderer. Do not present the result as a screenshot from the original editor. It is an export from Telario. If rendering differences could affect a decision, identify the source clearly. The team can then use the image to move forward without silently assigning it a level of fidelity nobody has tested. Provenance becomes useful context rather than a footnote added after confusion has already spread.
6. Filenames are part of the work
final, final2, and really_final mostly describe an emotional journey. A more useful name identifies the project, page or scope, and revision date. There is no need to invent a corporate taxonomy to rename three images. Someone else simply needs to know which one to open without reading the entire chat history.
Provenance matters as much as naming. If I export a page after a local edit, the result should be distinguishable from the image supplied by its author. If it is a proposal, I call it a proposal. If it records the received state, I say so. A working annotation should not become an official requirement merely because it is the oldest surviving file in somebody’s Downloads folder.
A small record can fit in one message: “received project A; exported page B using Telario; wording C still needs confirmation.” That cheaply preserves the route by which a decision was reached. The purpose of the tool is not to generate more files. It is to reduce the effort of understanding what the files mean. No export feature can take over that human responsibility completely. A carefully named image and two clear sentences can provide a better handoff than a large archive dropped into a channel with a cheerful thumbs-up.
7. Sixteen situations that change the handoff
The following situations are workflow examples, not additional application features. They help choose the smallest action that restores clarity rather than turning every attachment into a migration project. The ambition is deliberately modest: understand the work and continue. The right outcome may be an image, a question, a comparison, or simply a decision to ask for the original reference.
The project arrives five minutes before the meeting
Opening every page and reconstructing the whole system is an understandable temptation. With five minutes available, the priority is finding the screen under discussion and checking whether its essential content is readable. If page names are ambiguous, ask the author for the starting point. That question is more useful than hurried navigation while everyone watches a shared screen.
Prepare one view and a short list of uncertainties. Avoid making unannounced local edits during the meeting: viewers may assume they are seeing the original. Explicitly identify approximate icons or groups. Record decisions afterwards, rather than keeping only a screenshot. The received file remains the documentary reference until the team agrees on another revision. Here, Telario makes the conversation possible; it does not make five minutes equivalent to a full analysis phase. That is already valuable. A meeting can start from an honest partial understanding instead of a confident interpretation assembled under pressure and immediately mistaken for a specification.
There is a PNG, but it disagrees with the project
An image exported weeks earlier can be more misleading than no image at all. It appears to solve access while quietly introducing a revision mismatch. Check a recognisable detail, such as a changed heading or an added page. If the archive and image disagree, do not choose the authoritative version solely from their filenames.
Ask which revision should govern the work and preserve both sources with clear provenance. Telario can produce a new view of the available project, but it does not know the history of decisions made outside the file. Download time is not approval time. Describe the difference concretely: “the project places the button below the field; the PNG places it to the right.” That is a verifiable question. “These are different” is only the beginning of another waiting period. The useful deliverable is a resolved revision question, not merely two pictures that document the existence of confusion.
The page contains text you need to reuse
Transcribing an entire screen is an excellent way to introduce small errors that are difficult to notice. If the editor can read the text, Markdown export can help retrieve content from all pages. Review the result: visual order, association with controls, and message meaning are not guaranteed merely because the words appear in the output.
Use the export as working material and reconnect the text to its context. The same label on two pages may serve different purposes. An example message may not be final copy. Mark those distinctions before putting text into implementation or translation files. What matters is more than spelling: it is the role of each phrase. Telario reduces mechanical effort while editorial checking remains necessary. Correctly extracted text can still be used in the wrong place. For a useful handoff, note any wording that remains provisional and identify who can approve it. That prevents a convenient extraction from silently becoming an unintended content specification.
You need an answer about one element
You do not always need to send the entire project to another person. If the question concerns a field, prepare a page view and identify that control in the message. Include enough surrounding context to locate it without exposing unrelated material. The principle is straightforward: share enough information to answer the question.
Avoid references such as “that one” or “the second button,” especially if the recipient might have another revision open. Use the page name, visible wording, and relationship to neighbouring elements. Distinguish the received state from a local proposal if you changed anything. A well-prepared question can receive a short answer. A vague question distributes reconstruction work across several people and then appears mysteriously slow. The software helps you show something; precision in the request remains a choice made by the writer. If the difference matters to implementation, record the answer somewhere more durable than the memory of the person who happened to read the conversation first.
The document is private and the issue tracker is public
A GitHub issue is public even when the error was observed on your own computer. Before attaching a file or screenshot, consider customer names, addresses, internal systems, and details you are not authorised to disclose. A rendering problem does not automatically require publication of the project that revealed it.
An initial report can describe the app version, control type, expected result, and observed result. Recreate the behaviour with synthetic data where possible. That makes the example smaller, easier to understand, and less dependent on company context. A private attachment is not required to begin analysis. If investigation genuinely needs real data, sharing it is a separate decision. Local processing in the editor does not make it safe to manually publish everything visible on the screen. The strongest report often removes business context altogether while retaining the geometry, control properties, or sequence of actions needed to reproduce the fault. Clear reproduction and careful disclosure can support each other.
The correction looks tiny
Changing one word can have a small technical effect and a large organisational effect. Who approved the wording? Does the edit illustrate a proposal or represent an accepted requirement? Clarify the purpose before downloading another revision. Document control also means controlling what revisions are understood to mean.
For discussion, change the text locally and export a view labelled as a proposal. Keep the received material and avoid calling the result “final” merely because the edit was easy. Returning a .bmpr introduces the additional checks associated with experimental saving and reopening in the destination application. A small change does not remove those steps. An intervention can be simple to perform and still deserve a clear handoff. Technology reduces clicks; it should not reduce decision traceability. The practical question is whether another person can tell what changed, why it changed, and whether they are expected to adopt the result. If those answers are missing, the smallest correction can start a surprisingly large conversation.
The screen is readable but visually different
A font or spacing difference does not always have the same importance. It may be irrelevant when you need a field name. It may be decisive when discussing precise alignment or table capacity. Assess the result against the question being asked, rather than against a general wish that every pixel should match.
Compare the elements that influence the decision first. If rendering is approximate, use the result as informational support and request an original reference for sensitive details. Do not automatically edit the mockup to compensate for a renderer difference: that would turn a display limitation into a document change. Telario uses system fonts and independent graphics. Keep that distinction present when interpreting its output. Reading is useful, but it is not the same as certifying the original composition. A meaningful review can say, “the content is clear, but this alignment needs checking in the original.” That is more useful than either rejecting the entire page or pretending its appearance is exact.
A group contains details you cannot edit
Groups can be moved and resized as blocks, but individual children cannot be edited through the interface. This does not mean the underlying document has lost those details. It means the available editing level does not cover every structure the file can contain.
If you only need to read the group, check whether its essential content is visible. If a specific child needs changing, do not improvise a destructive reconstruction merely to obtain a superficially similar image. Describe the required correction or prepare a separate proposal while preserving the original group as a reference. Safe work distinguishes what the model preserves, what the renderer displays, and what the interface lets you change. Those are related capabilities, not interchangeable ones. A declared limitation prevents the app from promising control it does not yet provide. It also helps define a useful issue report: the missing capability is editing a particular nested element, not necessarily opening or preserving the entire group structure.
A colleague only wants to approve the arrangement
A layout review does not always require an editable archive. An image accompanied by a precise question may be sufficient and more convenient. Specify the subject: field order, action placement, or navigation sequence. Defining the scope protects the discussion from accidentally drifting towards details that are not settled yet.
When using a Telario export, check that approximations do not alter the very aspect being approved. A substituted icon may be acceptable for structural review and unsuitable for an iconography review. The same image can therefore be appropriate for one question and inappropriate for another. Record the outcome afterwards: approved, needs correction, or requires comparison with the original. “Seen” does not always mean “approved,” even when the message contains a highly persuasive green checkmark. The export should make the decision easier to express. It cannot decide what counts as approval on behalf of the team, and it should not be used to conceal an unresolved question behind a polished screenshot.
The file lives in a Dropbox folder
When a document is in a synchronised folder, Telario opens it as a file available on the computer. It does not manage synchronisation, coordinate concurrent revisions, or automatically update the shared archive. A service name in the filesystem path does not add collaboration features to the editor.
Before starting, check that the file is available locally and represents the expected revision. After exporting, deliberately choose where to save the result and how to name it. Do not assume a download placed in the wrong directory will enter the team’s workflow. If two people work on a project, a rule is still needed to decide which copy is authoritative. Telario addresses opening and local editing; shared version management remains a separate responsibility. Remembering that boundary prevents many perfectly synchronised surprises. It also stops a local proposal from being mistaken for an automatic update to everybody else’s project simply because the source file originally arrived through a shared service.
There are twenty pages and no obvious starting point
With many pages, a successful opening is only the first minute of analysis. Look for a working route: which screen introduces the flow, which pages represent alternative states, and which are supporting details? If the structure is unclear, one question to the author may save more time than browsing the entire archive.
Record the page names relevant to your task and why you selected them. The order of the list is not definitive evidence of functional sequence. Complex projects may contain revisions, branches, or alternatives. The app lists pages without providing full branch management; reading the list does not reconstruct the project’s entire history. Even a small working map in a message helps separate the current route from supporting material. Choose the question first, then navigate with a purpose. This approach is especially useful when a page name is meaningful to the author but ambiguous to a new recipient. The archive stores content; shared understanding still benefits from a small amount of explanation.
You are using a less powerful laptop
The browser really performs the work. That is a benefit of local architecture and a demand on your machine’s resources. Large archives, many images, and a history of edits can affect memory and responsiveness. An opening limit does not promise that every file close to the threshold will feel equally smooth on every computer.
Start with a representative page and observe the behaviour. Avoid running heavy exports and unnecessary edits simultaneously merely to discover how much pressure the tab can withstand. Preserve important results before a slow session becomes an unstable one. In a report, describe approximate file size and operation type without publishing confidential content. Performance is part of usability, but diagnosis needs concrete context. “It is slow” is a symptom; knowing when and on which structure it slows down is already a step towards an explanation. Useful reporting distinguishes opening time, page switching, dragging, and export time rather than treating every delay as evidence of the same underlying problem.
You want to compare two proposals
A useful comparison keeps unchanged elements stable. Two exports with different content, framing, or scale force the recipient to reconstruct context before evaluating the proposal. Prepare comparable views and state the difference you want discussed: wording, sequence, or arrangement. Make the comparison about the choice rather than the presentation.
Identify the provenance of any locally edited proposal. Do not overwrite the received reference or rely on memory to remember which file was the variant. Exporting moves the discussion outside the editor, but comparability is a decision made by the person preparing the material. Preserve the outcome alongside the selected option. Two images without a conclusion form an archive of possibilities, not a project decision. A small investment in context prevents the same question from returning next week under slightly more imaginative filenames. It also helps the next developer understand whether the alternative was rejected, deferred, or simply never reviewed, three states that can otherwise look remarkably similar in a folder.
The work is moving to a third developer
The next person does not possess the messages you had in mind while looking at the canvas. Prepare a handoff containing the reference project, a readable view, and the essential decisions. If Telario was used for exporting or preparing a proposal, explain that step instead of requiring someone to infer it from visual details.
Identify verified areas and anything still needing comparison with Balsamiq. A specific note is more useful than “check everything”: for example, the group on page two or the inferred links in a diagram export. Do not distribute an experimental copy as the only surviving original. Continuity depends on returning to a trustworthy reference. A tool intended to remove one blocker should not create a new dependency on the person who knows how the latest image was produced. Minimal documentation avoids that outcome. The test of the handoff is practical: can the next person identify the reference, understand the proposal, and continue without first reconstructing your private working context?
The boss finally sends the PNG
That is good news, not a defeat for the project. If the image is current and sufficient for your task, use it. The objective is not to prove that every workflow must pass through Telario. It is to make work less fragile when available tools and received documents fail to meet.
The editor remains useful for browsing the archive, extracting text, or preparing a small proposal. An improved handoff process may reduce the need to open it, and that is a positive result. Good personal tools do not need to defend the problem that created them. They can become another option, ready when necessary. If the normal process works, excellent: software can wait without taking offence. Unlike the deadline, which continues to arrive with admirable punctuality and absolutely no willingness to export images. The measure of success is less blocked work, whether that improvement comes from this application, a better export habit, or a combination of the two.
The request becomes “let everyone use it”
A solution useful on my machine is not automatically ready for every team. Wider use introduces different questions: who provides support, which files are representative, which limitations are acceptable, and which distribution conditions apply? Public code visibility does not settle those choices by itself.
Start with a small trial using nonconfidential documents and explicit success criteria. Verify opening, readability, and exports before including original-format saving. Gather failures as reproducible cases rather than general verdicts. Telario’s promise remains proportionate: reduce a concrete blocker through a first working version with documented limitations. Bringing it to more people may be a sensible evolution, but it requires additional work. The fact that a PNG joke makes half the office smile is encouraging; it does not replace an adoption plan. A good trial should end with clear findings about suitable tasks, known gaps, and the next decision, rather than an expectation that one successful demonstration has removed every future support responsibility.
8. The minimum handoff I would like to receive
The ideal package is small: the original project, current exports of important pages, a revision note, and unresolved questions. I am not asking for a manual with every wireframe. I am asking that recipients can distinguish what to inspect, why it matters, and how final it is. A file can contain many screens; a handoff should contain at least one understandable intention.
If that habit becomes normal, Telario can remain a tool at the edge of the workflow. When the habit is absent, the app restores an opportunity to act. Either way, the objective is the same: spend less time arranging access to information and more time doing the work that information enables. The application and the process improvement are compatible ways to reach that outcome.
The story does not need a villain. Balsamiq does its job, my boss makes designs, and I try to develop them. The problem lives between different tools and imperfect handoffs. Telario is a small bridge built for that particular crossing. Expected traffic is modest: a few pages, some text, and an image that can finally be opened without asking for a favour. That is enough of an engineering brief to justify a personal project, and specific enough to keep its claims grounded in actual behaviour.
9. Where to try it, and what to expect
Start with the setup guide, explore the synthetic demo, and verify essential operations. Before using a real archive, read compatibility and limits. For precise behaviour and validation results, the reference is the Telario repository. Saving .bmpr remains experimental. Keep originals and check saved copies in the destination workflow before relying on them.
My favourite result is not a statistic. It is the moment a file opens and I can return to thinking about the screen. Progress no longer requires the right colleague, message, and export to appear in the same time window. I can start with what I have while understanding what I am viewing and which details still need checking. That combination of independence and explicit limits is more useful than confidence without evidence.
One last practical detail: record which tool produced an export. This is not ceremony. If someone notices a difference tomorrow, knowing that the image came from Telario helps them check the renderer before questioning the original project. One line of context can prevent an entire conversation from heading in the wrong direction. That is precisely the kind of small economy that makes this project worthwhile.
The PNG can follow later. Meanwhile, the work has already restarted.

