SHIPSTER / MARITIME AI TOOLKIT

Simplifying maritime
documents with AI

A shared workspace for generating, comparing and checking shipping documents — with the source always within reach.

Discovery · UX & UI design · Development handoff
One toolkit. Two clear starting points: generate a document or compare existing ones.↗ View detail
10Document workflows
2Generate & compare
1Shared review framework
01 / PROBLEM

A fast result still needs to be trusted

Shipping teams work across bills of lading, letters of indemnity, voyage instructions and financial statements. The same vessel, cargo and commercial details appear in several documents, often in different formats.

The challenge was to reduce repetitive work while keeping AI output easy to check, correct and trace back to its source.

My role

I led discovery and all interface design, then worked with the product owner to prepare the designs and hand them over to development.

Deliverables

A coherent toolkit, complete task flows and detailed states for upload, preparation, generation, comparison, review, export and recovery.

02 / GOALS

Make the work simpler. Keep the operator in control.

Reduce repeated work

Reuse source information and templates rather than asking operators to re-enter the same details.

Make checking practical

Bring documents, extracted fields and differences into one workspace.

Keep control visible

Let operators correct fields, reject matches, resolve missing information and choose when to export.

Consistency in the workflow.
Detail where the task needs it.
03 / DISCOVERY

Different documents. Three recurring challenges.

I led discovery across the document tasks. The final designs address three recurring needs: preparing messy inputs, checking uncertain results and avoiding a new interaction model for every tool.

Messy inputs

Bundled PDFs, inconsistent formats and information pasted from email.

Uncertain results

Missing fields, suggested document matches and totals that need verification.

Repeated interactions

Upload, process, review and export recur across the toolkit.

DOCUMENT ECOSYSTEM

Generate

Bill of lading → Letter of indemnity

Recap → Voyage instructions

Bunker nomination → Instructions

Compare & check

Letters of indemnity

Agent & master statements of facts

Manifests, bills of lading & mate’s receipts

Hire statements

Shared preparation → Task-specific review → Controlled output
RETROSPECTIVE UX RECONSTRUCTION
Discovery evidence: designed behaviour, working hypotheses and proposed research are clearly separated.↗ View full board

Four roles. Different checks. One workspace.

These provisional role profiles explain who the workflows serve and what each person needs to check. They are inferred from the designs, rather than presented as interview findings.

01 / ROLE PROFILE

Operations specialist

Prepare the right documents

Works across bills of lading, letters of indemnity and manifests. Needs to resolve missing information without losing the original source.

Design responseVisible input readiness, page splitting and editable fields beside the source.
02 / ROLE PROFILE

Voyage coordinator

Turn terms into instructions

Brings together recaps, ports, dates and bunker details. Needs to check that instructions reflect the current agreement.

Design responseStructured operational fields and a reviewable draft before output.
03 / ROLE PROFILE

Commercial reviewer

Find the difference that matters

Checks hire statements, balances and commercial terms. Needs precise discrepancies with enough context to judge them.

Design responsePaired originals, change navigation and document-specific totals.
04 / ROLE PROFILE

Team lead / quality reviewer

Know what is ready to use

Needs a clear distinction between generated work and checked work, with an identifiable version to hand over.

Design responseExplicit review actions, saved work and controlled export.
THE EXPERIENCE WE ARE DESIGNING FOR

Less fragmented work. Clearer checkpoints.

The journey brings preparation, processing and source checking into one workspace. This map connects the workflow friction to the intended experience.

Journey map: gather, prepare, process, review and use — with current-state hypotheses and design responses.↗ View full board

From friction to a design decision

Bundled or incomplete inputsMake preparation a visible stepPage previews, readiness checks and recoverable errors
An AI suggestion can be wrongKeep the evidence closeSource panels, editable fields and confirm / reject controls
Many tools repeat the same actionsReuse the interaction modelChoose → prepare → process → review → export
VALIDATION PLAN

Learn from the task, then test the decision.

The proposed research moves from observation and interviews to prioritised requirements and task-based testing. It focuses on how operators judge whether a document is ready to use.

Proposed discovery programme: recruit, observe, interview, synthesise and test, with the evidence and outputs to capture.↗ View full board
Explore the discovery framework +

The 32-part UX dossier brings together the project brief, evidence register, stakeholders, role profiles, jobs to be done, current and future journeys, task analysis, information architecture, requirements and design traceability.

What the designs show

Ten document tasks, shared preparation and review patterns, source comparison, saved work and recovery states.

What needs validation

Role assumptions, the cost of switching documents, the meaning of match scores and whether the review steps catch consequential errors.

The proposed research includes contextual interviews and observation, recruitment across the four roles, synthesis, prioritisation and seven task-based usability scenarios. No participant findings or measured outcomes are claimed.

Read the full UX discovery board ↗
04 / USER FLOW

One familiar path through every tool

01ChooseSelect the task
02PrepareCheck the inputs
03ProcessCreate a result
04ReviewVerify & amend
05ExportUse the output

Generation flows combine source documents with templates and company details. Comparison flows pair documents, highlight changes and keep the originals available for checking.

Check the input

Split bundled files, confirm page ranges and resolve unsupported documents before processing.

Check the relationship

Confirm or reject suggested matches using the actual vessel, cargo and document details.

Check the result

Amend missing fields, inspect differences and verify totals before copying or exporting.

FROM JOURNEY TO INTERACTION

The click that moves the work forward

15 mapped journeys

The detailed flows connect actual interface screens. Arrows start at the control the operator clicks; automatic transitions are shown separately. The comparison journey below follows upload, processing, review and output.

LETTER OF INDEMNITY / COMPARISON1 / 9

Choose the comparison task

Start with two versions of a letter of indemnity.

USER ACTIONClick Compare to choose the source documents.
Click a screen to enlarge
View the complete journey map ↗
Complete comparison journey with controls and transitions.↗ View full board
01Generate documents
02Compare versions
03Match cargo documents
04Split a batch
05Manage saved work
06Export & recover
Explore all 15 annotated user journeys ↗

Flow reconstructed from the designed states. Exceptions include rejected matches, stopped processing, missing information and unsaved changes.

05 / WIREFRAMES

Keep source and result within reach

The workspace changes to suit the task, while the header, progress and primary actions stay familiar.

STRUCTURE BEFORE SURFACE

Strip back the UI. Keep the decisions.

150 wireframe states
Reconstructed comparison wireflow: low-fidelity screens retain the actions, decision points and recovery routes.↗ View full board
01 / STRUCTUREWireframe

Define what belongs on screen and where the next action sits.

02 / BEHAVIOURConnected journey

Map the click, the response and the route back when something goes wrong.

03 / INTERFACEDesigned workspace

Use hierarchy, status and proximity to make the review practical.

View the complete low-fidelity wireflows ↗

Generation workspace

Settings
Template
Company details
Editable draft
Review fields
Resolve omissions
Source document
Reference detail

Comparison workspace

Original A
Original B
Changes
Filter & navigate
Review differences

These wireframes were reconstructed from the designed journeys to explain the interaction logic. They are not original discovery artefacts.

06 / UI DESIGN

A toolkit built around review

Start with the task

Task cards make the expected input and output clear. Generate and compare are separate entry points, with favourites for frequently used tools.

The home screen organises document tasks by purpose, with a consistent card structure.↗ View detail

Prepare the document before processing

For bundled PDFs, operators can divide pages manually, by a fixed count or with AI assistance. Thumbnails and page ranges make the preparation visible before the task runs.

Page previews and split controls help operators check how a bundled PDF will be divided.↗ View detail

Review a draft beside its source

Editable fields sit beside the original document. Missing information is called out, so the operator can resolve omissions before saving, copying or exporting.

The letter-of-indemnity draft keeps extracted information and the original source side by side.↗ View detail
A closer look at the draft: missing fields are visible and corrections stay within the review workspace.↗ View detail

A suggested match is a decision to review

Document pairs expose the details needed to confirm or reject a suggestion. A match score supports the decision; it does not replace checking the evidence.

Suggested mate’s-receipt and bill-of-lading pairs can be checked, confirmed or rejected.↗ View detail

Make differences easier to act on

Paired originals, labelled insertions and deletions, filters and change navigation help reviewers focus on relevant differences. An email draft can be copied after review.

The comparison workspace connects individual changes to both original documents.↗ View detail

The denser layout trades some reading space for continuity: the reviewer can inspect a change without leaving the comparison.

Use the right review model for the document

Manifest checks focus on cargo quantities and totals. Statements of facts focus on events, missing entries and timestamps. Hire statements focus on balances and discrepancies that need verification.

Manifest review makes cargo quantities, volume and document totals available for checking.↗ View detail
Statements-of-facts comparison helps operators inspect event sequences and discrepancies.↗ View detail
Hire-statement review brings financial differences into a structured checking view.↗ View detail

Turn operational detail into usable instructions

Voyage and bunker workflows bring together source text and structured operational details, so the final instructions can be reviewed before use.

Voyage instructions organise source information into an editable operational document.↗ View detail
Bunker instructions use the same preparation and review approach for a different document task.↗ View detail
07 / DESIGN GUIDE

A shared visual language for a complex toolkit

Workspace#071d20
Primary action#5450d8
Supporting action#008e8c
Confirmed#1d9b33
Needs attention#d89826

A dark teal workspace frames the product. Purple and teal distinguish actions, while status colours are paired with labels so meaning does not depend on colour alone.

Typography

Roboto and Kanit support the product interface. Inter gives this case study the same editorial treatment as the portfolio.

Reusable patterns

Consistent headers, progress states, review actions and document panels keep navigation familiar as tasks change.

08 / HANDOFF

Designing the states around the happy path

I worked with the product owner to hand the designs over to development. The handoff covered more than finished screens: it described how each task behaves while inputs, results and saved work change.

Input & preparation

Supported files, bundled documents, page division and readiness checks.

Processing & recovery

Progress, stopping a task, failures and returning to a usable state.

Review & persistence

Missing fields, rejected matches, amendments, saved work and unsaved-change exits.

Output

Copying, downloading and exporting only after the operator has reviewed the result.

TRY THE COMPLETE JOURNEY

From the first upload to the final export.

The interactive Figma prototype brings the document workflows, recovery states and a plain-English usage guide together. It uses sample data and simulated processing.

Open the working prototype ↗
NORTH STAR / UX SUCCESS

More documents completed correctly, with less effort.

A North Star metric is the single measure that keeps design decisions focused on user value. For Shipster, the proposed measure is the percentage of started document tasks completed independently, reviewed against the source and exported without a critical error.

Verified successful tasks ÷ all started tasks × 100
ILLUSTRATIVE SCENARIO · PROPOSED TARGETS, NOT MEASURED RESULTS
Illustrative baseline60%
Design target90%
+30 percentage points
Baseline scenario
Target scenario

The target combines completion with accuracy. A quick export only counts if the document has been checked and contains no critical errors.

ILLUSTRATIVE TARGET50% less time20 min → 10 min

Median time to verified completion

Shared preparation and source-adjacent review reduce switching and repeated entry.

ILLUSTRATIVE TARGET60% less rework5 corrections → 2

Median avoidable corrections per task

Readiness checks and visible omissions catch problems before output.

ILLUSTRATIVE TARGET+2 ease points4/7 → 6/7

Post-task ease rating

A consistent workflow makes each tool easier to learn and complete.

All figures above are illustrative planning assumptions. Baselines must be established through equivalent task tests before improvements can be reported as outcomes.

How I would measure improvement +

Compare the current workflow with the redesigned workflow using equivalent documents, balanced task order and representative operators. Record every started task, completion, assistance, review, export, correction and critical error. Verify the output independently against the source.

Report task counts, sample size and uncertainty alongside the completion rate. Separate generation, comparison and matching tasks so a change in task mix does not create a false improvement. Capture median completion time and corrections, then ask operators to rate task ease from 1 (very difficult) to 7 (very easy).

Quality guardrail: critical errors must not increase. A critical error is an incorrect vessel, cargo, financial amount or operational instruction that makes the output unsafe or unusable. An unchecked export does not count as verified success.

What I would validate next

Task-based testing should check whether operators can prepare a bundled PDF, resolve a missing field, reject an incorrect match and find a meaningful difference. Quality checks should compare results with the source. Operational measures should track completion time and correction effort.

Proposed validation measures; these are not presented as measured outcomes.

AI does the first pass.
The operator makes the final call.

The core design decision was proximity: keep the source, the result and the next action close enough that checking becomes part of the workflow.