openfront-hotel-custom-storefront

Plan and build custom Openfront Hotel storefronts by inspecting source architecture and GraphQL contracts.

27|5|Updated Aug 10, 2022
One-click install
npx skills add https://github.com/openshiporg/docs --skill openfront-hotel-custom-storefront-openshiporg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openfront-hotel-custom-storefront
Source: https://github.com/openshiporg/docs/tree/main/public/skills/openfront-hotel-custom-storefront
Command: npx skills add https://github.com/openshiporg/docs --skill openfront-hotel-custom-storefront-openshiporg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Customizing a hotel storefront without understanding the existing codebase leads to broken booking flows, unauthorized data access, and duplicated business logic. This Skill guides a disciplined process of source inspection, user interviews, and contract verification before any code changes. ## Core Features & Use Cases - Source Orientation: Maps the Openfront Hotel repository structure, including features/storefront, app/** routes, Keystone models, and schema.graphql, so changes start from the real architecture. - Structured Discovery: Interviews the user about target revision, built-in versus separate client mode, required journeys, and deployment constraints before proposing implementation. - Contract Verification: Traces every data loader, GraphQL operation, access rule, and provider integration to produce a capability matrix distinguishing presentation-only changes from backend-contract work. - Use Case: A team wants a rebranded booking experience deployed separately from the built-in storefront. The Skill walks them through pinning the schema, generating strict types, keeping privileged credentials server-side, and testing anonymous, wrong-tenant, and provider-failure scenarios. ## Quick Start Use the openfront-hotel-custom-storefront skill to plan a custom booking storefront against my Openfront Hotel source checkout.

Frequently Asked Questions about openfront-hotel-custom-storefront

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the Openfront Hotel storefront?

Start by inspecting the `features/storefront` directory, which contains the built-in screens, data loaders, and GraphQL calls. Then decide whether to adapt the built-in client in place or build a separately deployed client against the pinned schema.

Should I adapt the built-in storefront or build a separate client?

Adapt the built-in client when you can reuse existing sessions, transport, and server operations safely. Build a separate client when you need independent deployment, but keep privileged credentials server-side and never expose an arbitrary GraphQL proxy.

How do I verify which GraphQL operations the Hotel backend supports?

Read `schema.graphql`, the Keystone model and field access rules, and the custom query and mutation resolvers. Trace every operation the built-in screens actually call rather than assuming Ecommerce roots exist in this vertical.

Can I reuse Ecommerce storefront patterns for the Hotel product?

No. The Hotel vertical uses room/rate discovery, availability, booking, and stay state with its own workflow nouns and authority boundaries. Borrowing Ecommerce GraphQL roots without validating they exist and are authorized will produce broken or unsafe flows.

What security checks are required for a separate Hotel client?

Pin the exact schema, generate strict types, runtime-validate JSON and custom scalars, and fail closed when a contract is absent. Test anonymous, wrong-user, wrong-tenant, stale, duplicate, timeout, and provider-failure behavior against disposable data.