Hyvä Storefront Pod SOW Worksheet
Use this worksheet to turn a proposed Hyvä team into a bounded statement of work. It covers named people, compatibility decisions, evidence, acceptance, release, rollback, documentation, handover, support, and exit.
· Sources checked August 28, 2026
Buyer tool. Not affiliated with Hyvä Themes or Adobe Inc. This is not legal advice.
Working rule: write who does what, for which routes and versions, using which evidence, by when, under whose approval, and what happens if the assumption fails. Avoid phrases such as “make the site fast” or “ensure compatibility” without a protocol and owner.
The SOW should reference versioned attachments. At minimum, attach the named-person schedule, current-state baseline, compatibility register, deliverable schedule, acceptance matrix, release and rollback plan, and handover schedule.
Name the contract, parties, owners, and attachments
Keep a version history. A changed attachment can change scope even when the main SOW text stays the same.
Document
- SOW title: _______________________________________
- SOW ID: __________________________________________
- Version and date: _________________________________
- Master agreement: _________________________________
- Effective date: ___________________________________
- Target completion: ________________________________
Parties and owners
- Buyer legal name: _________________________________
- Supplier legal name: _______________________________
- Buyer product owner: _______________________________
- Buyer technical owner: ______________________________
- Supplier delivery owner: ____________________________
- Commercial and legal contacts: ______________________
State the exact storefront change
Describe the target outcome without promising a result that depends on traffic, customer behavior, external services, or conditions outside the pod's control.
Outcome statement
Write: The supplier will deliver __________________ for __________________ stores and routes on __________________ edition and version using __________________ Hyvä products. The buyer will accept the work using Attachment ____.
________________________________________________________________
________________________________________________________________
Business constraints
- □ Revenue or release blackout: ________________________
- □ Required launch window: ____________________________
- □ Regulatory or accessibility need: ____________________
- □ Brand and content constraint: ________________________
- □ Integration or data constraint: _______________________
- □ Internal-team or vendor dependency: __________________
Included
- □ Websites, stores, views, domains: ____________________
- □ Pages, templates, states, routes: _____________________
- □ Hyvä products and versions: _________________________
- □ Modules, custom code, and services: __________________
- □ Design, content, migration, and data work: _____________
- □ Testing, release, stabilization, support: _______________
Excluded
- □ Backend features not touched: ________________________
- □ Data or content not migrated: _________________________
- □ Stores, routes, devices, or browsers excluded: __________
- □ Integrations or licenses excluded: _____________________
- □ Marketing, CRO, SEO, or analytics work excluded: ________
- □ Support after the stated period excluded: ______________
Attach a route list and current-state baseline. “All storefront pages” is too broad when custom routes, account states, fallback pages, and external redirects are not enumerated.
Make the proposed pod a contract schedule
Use the same people approved in the Hyvä developer role map. State whether the supplier owns a bounded outcome or supplies capacity under buyer direction.
| Person and function | Location, overlap, allocation | Term and evidence | Authority and approval |
|---|---|---|---|
| Name: ______________ Function: _____________ | Location: _____________ Overlap: ______________ Allocation: _____________ | Start: ______ End: ______ Evidence ref: ____________ | Decides: ________________ Buyer approved: □ |
| Name: ______________ Function: _____________ | Location: _____________ Overlap: ______________ Allocation: _____________ | Start: ______ End: ______ Evidence ref: ____________ | Decides: ________________ Buyer approved: □ |
| Name: ______________ Function: _____________ | Location: _____________ Overlap: ______________ Allocation: _____________ | Start: ______ End: ______ Evidence ref: ____________ | Decides: ________________ Buyer approved: □ |
| Name: ______________ Function: _____________ | Location: _____________ Overlap: ______________ Allocation: _____________ | Start: ______ End: ______ Evidence ref: ____________ | Decides: ________________ Buyer approved: □ |
Substitution clause worksheet
- Minimum notice: ____________________________________
- Buyer approval before access: ________________________
- Evidence equal to or stronger than: ____________________
- Required overlap and transfer: ________________________
- Schedule and cost treatment: __________________________
- Right to reject or end affected work: ____________________
Working cadence
- Planning and demo cadence: __________________________
- Required overlap hours: ______________________________
- Decision-response time: ______________________________
- Issue and escalation channel: _________________________
- Repository and review rules: __________________________
- Time, allocation, and absence reporting: ________________
Version the evidence that supports the estimate
Attach the completed extension and checkout compatibility register. State which unknowns are included in discovery and how they can change later work. Name the Residual risk that remains after planned controls.
| Deliverable | Required content | Owner, reviewer, due | Acceptance and effect |
|---|---|---|---|
| Current-state baseline | Editions, versions, stores, themes, products, environments, code and content sources. | Owner: ______ Reviewer: ______ Due: ______ | Accepted when: __________ If missing: __________ |
| Route and state map | Pages, account states, checkout paths, custom routes, fallbacks, external returns, failures. | Owner: ______ Reviewer: ______ Due: ______ | Accepted when: __________ If missing: __________ |
| Module and custom-code register | Packages, versions, functions, routes, current owners, overrides, scripts, content security policy. | Owner: ______ Reviewer: ______ Due: ______ | Accepted when: __________ If missing: __________ |
| Compatibility decision register | Native, compatibility module, custom adaptation, fallback, replace or retire, or test pending, with evidence. | Owner: ______ Reviewer: ______ Due: ______ | Accepted when: __________ If missing: __________ |
| Estimate and dependency update | Work, owner, effort basis, buyer input, vendor dependency, license, risk, assumption, and exclusion. | Owner: ______ Reviewer: ______ Due: ______ | Accepted when: __________ If changed: __________ |
| Residual-risk decision | Customer effect, likelihood, control, remaining risk, release condition, rollback, business owner. | Owner: ______ Reviewer: ______ Due: ______ | Accepted when: __________ No-go when: __________ |
Discovery completion rule
- □ Critical routes are inventoried.
- □ Checkout combinations and failures are mapped.
- □ Custom code and package versions are known.
- □ Test-pending items have owners and due dates.
- □ Estimate assumptions and exclusions are visible.
- □ Buyer accepted residual risks or no-go conditions.
Estimate change rule
Write: If discovery shows __________________, the supplier will provide evidence and a change request covering scope, schedule, price, acceptance, and risk before affected implementation begins.
Buyer response time: _________________________________
Work allowed before approval: _________________________
List artifacts, not only activities
“Development” and “testing” are activities. A deliverable is a reviewable artifact with an owner, version, due date, storage location, and acceptance rule.
| Milestone or artifact | Content and location | Owner, reviewer, date | Acceptance evidence |
|---|---|---|---|
| Architecture and decisions | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Design system, pages, states, assets | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Frontend components and templates | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Modules, adaptations, integrations | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Checkout and customer flows | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Content, analytics, consent, SEO | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Test automation and evidence | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
| Runbooks and documentation | ____________________________ | Owner: ______ Reviewer: ______ Date: ______ | ____________________________ |
Code and review rules
- □ Buyer-controlled repository and branch rules
- □ Commit, pull request, review, and merge authority
- □ Static analysis, tests, build, and security checks
- □ Code ownership, third-party licenses, and notices
- □ No secrets or production personal data in code or tickets
- □ Accepted dependency, patch, fork, and upgrade policy
Demonstration and decision rules
- □ Demonstration cadence and environment
- □ Required buyer participants
- □ Decision deadline and effect of delay
- □ Retained recording, notes, screenshots, or results
- □ Defect versus change-request boundary
- □ Accepted exception authority and expiry
Separate evidence families and sign-off authority
A single Lighthouse score or a successful happy-path checkout is not a complete definition of done.
| Evidence family | Scope and protocol | Pass and exception rule | Owner and sign-off |
|---|---|---|---|
| Functional | Routes, states, data, integrations, failures, recovery: __________________ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| Visual and responsive | Pages, states, viewports, browsers, reference, tolerance: ______________ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| Accessibility | Standard, routes, manual and automated checks, assistive technology: ____ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| Performance | Lab pages and protocol; field source, percentile, window, scripts: ________ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| Analytics and consent | Events, parameters, consent states, destinations, duplicate control: _____ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| SEO and content | URLs, metadata, rendering, canonicals, structured data, links, redirects: ___ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| Security and privacy | Access, secrets, content security policy, data exposure, logs, vendors: ____ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
| Release and operations | Build, deploy, smoke, monitoring, rollback, incident, stabilization: _______ | Pass: __________ Exception: __________ | Test: ______ Sign: ______ |
Definition of done
- □ Included deliverables are complete and stored.
- □ Code is reviewed, merged, built, and traceable.
- □ Required tests pass or have approved exceptions.
- □ Critical defects are closed under the severity rule.
- □ Compatibility register matches the delivered build.
- □ Documentation and runbooks are current.
- □ Release rehearsal and rollback evidence are accepted.
- □ Access, IP, handover, and support duties are ready.
Defect and exception rule
- Severity definitions: __________________________________
- Release-blocking severities: ___________________________
- Response and fix targets: ______________________________
- Retest owner: ________________________________________
- Exception approver: ___________________________________
- Exception expiry and remediation: _______________________
- Dispute and independent review: _________________________
Make delay and change visible early
A milestone should end with accepted evidence. State how buyer delays, vendor delays, unavailable environments, new findings, and changed requirements affect the plan.
| Milestone | Supplier evidence | Buyer input and decision | Date and delay rule |
|---|---|---|---|
| Discovery complete | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
| Architecture and design accepted | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
| Core routes implemented | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
| Checkout and integrations accepted | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
| Regression and readiness accepted | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
| Release and stabilization complete | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
| Handover and closure accepted | ____________________________ | ____________________________ | Target: ______ Delay: ______ |
Assumption and dependency record
- Assumption or dependency: ____________________________
- Owner: _____________________________________________
- Evidence or due date: _________________________________
- If false or late: ______________________________________
- Work that can continue: _______________________________
- Change or stop authority: ______________________________
Change request record
- Change ID and requestor: ______________________________
- Reason and evidence: __________________________________
- Scope and deliverable effect: ___________________________
- People, schedule, and price effect: ______________________
- Acceptance and risk effect: _____________________________
- Approved by and date: __________________________________
Name the live-operation duties
Release ownership includes authority and availability, not only a deployment command. Write the go or no-go decision, monitoring window, rollback triggers, incident route, and support transition.
Release preparation
- □ Production-like rehearsal and evidence
- □ Data, content, configuration, static assets, cache, index plan
- □ Freeze, backup, maintenance, communication, and vendor windows
- □ Final smoke suite and named testers
- □ Go or no-go checklist and authority
- □ Deployment and observation staffing
Rollback
- □ Rollback method and maximum decision time
- □ Trigger metrics, defects, integration failures, or business events
- □ Data and order reconciliation
- □ Cache, index, asset, configuration, and external-service recovery
- □ Rollback authority and executor
- □ Customer, internal, and vendor communication
Monitoring and incidents
- □ Availability, errors, logs, checkout, payment, integrations
- □ Performance, Core Web Vitals, analytics, consent, SEO signals
- □ Dashboards, alerts, recipients, thresholds, escalation
- □ Incident severity, response, update cadence, resolution evidence
- □ Third-party vendor escalation and account owner
Stabilization
- Start and end: ________________________________________
- Coverage hours: ______________________________________
- Included defects and exclusions: ________________________
- Response and resolution targets: _________________________
- Daily or weekly reporting: _______________________________
- Exit criteria and support receiver: ________________________
Give the buyer a complete and operable result
Delivery is not complete when the storefront is live but the buyer lacks code, assets, decisions, operating knowledge, access records, or a support owner.
Access and security
- □ Named accounts, least privilege, approval, and expiry
- □ MFA, secrets manager, credential sharing prohibition
- □ Production data and personal-data boundary
- □ Device, network, repository, and vendor-access rules
- □ Security event and vulnerability reporting
- □ Access review and revocation evidence
IP and third-party materials
- □ Buyer-owned code, designs, content, data, and documents
- □ Supplier background materials and granted rights
- □ Open-source and commercial packages, licenses, notices
- □ Fonts, images, icons, code snippets, AI-assisted outputs
- □ Forks, patches, source access, update and support rights
- □ Assignment timing and acceptance condition
Documentation set
- □ Architecture, routes, modules, interfaces, decisions
- □ Local setup, build, test, deploy, rollback, monitor
- □ Theme, components, Tailwind, Alpine.js, content rules
- □ Checkout, payment, shipping, tax, fraud, external services
- □ Accessibility, performance, analytics, consent, SEO protocols
- □ Known issues, exceptions, risks, backlog, vendor contacts
Handover and offboarding
- □ Knowledge-transfer sessions, audience, recording, questions
- □ Code, assets, documents, reports, licenses, and decision logs
- □ Open defects, risks, changes, support and warranty duties
- □ Repository, cloud, vendor, analytics, design, and tool access
- □ Supplier account removal and buyer access verification
- □ Final handover review, acceptance, and transition date
| Artifact or access | Owner and location | Receiver and review | Accepted, missing, action |
|---|---|---|---|
| Code, branches, tags, build | ____________________________ | ____________________________ | □ Accepted □ Missing Action: __________ |
| Designs, assets, content rules | ____________________________ | ____________________________ | □ Accepted □ Missing Action: __________ |
| Architecture and compatibility | ____________________________ | ____________________________ | □ Accepted □ Missing Action: __________ |
| Tests and acceptance evidence | ____________________________ | ____________________________ | □ Accepted □ Missing Action: __________ |
| Release, rollback, monitoring, support | ____________________________ | ____________________________ | □ Accepted □ Missing Action: __________ |
| Licenses, vendors, access inventory | ____________________________ | ____________________________ | □ Accepted □ Missing Action: __________ |
Make payment follow accepted evidence
Have qualified legal, procurement, tax, privacy, security, and finance reviewers adapt this worksheet to the contract and jurisdiction.
Commercial basis
- □ Fixed price, time and materials, capacity, or hybrid
- □ Currency, rates or milestone amounts, taxes, expenses
- □ Included hours, roles, environments, vendors, licenses
- □ Timesheet, milestone, evidence, and invoice approval
- □ Overtime, out-of-hours release, travel, third-party cost
- □ Holdback, credit, cap, or remedy where agreed
Warranty and support
- Warranty start and end: _______________________________
- Covered defects: _____________________________________
- Excluded changes and external causes: __________________
- Severity, response, resolution, update: __________________
- Support hours, channel, and named receiver: ______________
- Transition to ongoing support: ___________________________
Suspension and termination
- □ Triggers, notice, cure, and immediate-stop conditions
- □ Payment for accepted work and disputed work
- □ Safe stopping point and production protection
- □ Code, documents, data, IP, licenses, and access return
- □ Transition help, rate, duration, and cooperation
- □ Confidentiality, privacy, security, and survival terms
Final close
- □ Deliverables and exceptions accepted
- □ Open defects and warranty owner transferred
- □ Handover evidence accepted
- □ Supplier access revoked and buyer access verified
- □ Final invoice and credits reconciled
- □ Contract, evidence, and decision archive complete
Keep the working packet versioned
List every attachment here. State which document wins if two documents conflict.
| ID and attachment | Version and date | Owner and approval | Order of precedence |
|---|---|---|---|
| A1. Current-state and work-boundary baseline | ________________ | ________________ | ________________ |
| A2. Named-person and responsibility schedule | ________________ | ________________ | ________________ |
| A3. Extension and checkout compatibility register | ________________ | ________________ | ________________ |
| A4. Milestone and deliverable schedule | ________________ | ________________ | ________________ |
| A5. Acceptance and definition-of-done matrix | ________________ | ________________ | ________________ |
| A6. Release, rollback, monitoring, and stabilization plan | ________________ | ________________ | ________________ |
| A7. Access, security, IP, documentation, and handover schedule | ________________ | ________________ | ________________ |
| A8. Assumption, dependency, risk, exception, and change log | ________________ | ________________ | ________________ |
Review record
- Product review: _______________________________________
- Technical review: _____________________________________
- Security and privacy review: ____________________________
- Accessibility review: __________________________________
- Procurement and finance review: _________________________
- Legal review: _________________________________________
Approval record
- Buyer authorized signatory: _____________________________
- Date: _______________________________________________
- Supplier authorized signatory: __________________________
- Date: _______________________________________________
- Open conditions: ______________________________________
- Effective after: ________________________________________
Technical source notes
The worksheet uses current official Hyvä documentation for credential, compatibility, fallback, and Enterprise prompts. The contract structure is an editorial buyer framework.
- Hyvä certification documentation
- Hyvä compatibility module guidance
- Luma checkout with Hyvä Themes
- Hyvä Enterprise installation and compatibility guidance
This worksheet is not a contract and is not legal, tax, security, accessibility, or financial advice. Product versions, documentation, laws, standards, and business conditions change. Use qualified reviewers and the exact facts of the proposed engagement.