openfront-convenience-custom-storefront

Plans and builds custom storefronts for Openfront Convenience by inspecting source routes and GraphQL contracts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building a customer-facing storefront for Openfront Convenience is risky because the source has no canonical storefront layer, and guessing at routes or GraphQL operations leads to broken or unauthorized flows. This Skill guides a disciplined process: orient in the actual source, interview stakeholders, inspect real routes and schema contracts, then adapt the built-in client or build a safe separate one. ## Core Features & Use Cases - Source Orientation & Inspection: Enumerates actual app routes, traces screen components and their data loaders, and reads schema.graphql, access rules, and resolvers before proposing any code. - Structured User Interview: Asks a concise question set covering target revision, built-in versus separate client, required journeys, brand, accessibility, and available test environments. - Capability Matrix & Safe Client Boundaries: Classifies each operation as verified, presentation-only, needs backend contract, blocked, or absent, and enforces rules like pinned schemas, named operations, and no arbitrary GraphQL proxying. - Use Case: A team wants a new convenience retail customer portal. The Skill inspects the repository, discovers which public routes and GraphQL operations actually exist, flags missing backend contracts for checkout, and produces a handoff report with implemented files, tests, and blockers. ## Quick Start Ask the assistant to plan a custom storefront for your Openfront Convenience checkout by inspecting the current source and interviewing you about the required customer journeys.

Frequently Asked Questions about openfront-convenience-custom-storefront

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

FAQPage Schema
How do I build a custom storefront for Openfront Convenience?

Start by inspecting the actual source: enumerate app routes, trace screen components and their data loaders, and read schema.graphql for safe operations. Then decide whether to adapt the built-in client or create a separate client with pinned schemas and named operations.

Does Openfront Convenience have a built-in storefront to customize?

No, the current source has no canonical features/storefront directory. You must inspect app routes for existing public, portal, or client-facing pages and treat any new customer experience as potentially requiring new backend contracts first.

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

Adapt the built-in client when you can reuse existing session, transport, design tokens, and safe named server operations. Build a separate client when you need independent deployment, using a trusted pinned endpoint, strict types, and server-side credentials behind a BFF.

Can I expose the GraphQL API directly to a browser storefront?

No. Never expose an arbitrary GraphQL proxy or accept browser-selected fields, operations, or endpoint URLs. Use checked named operations, pin the exact schema, validate responses at runtime, and fail closed when a required contract is absent.

What happens when a required storefront operation has no backend contract?

The Skill marks it as needing a backend contract or blocked in the capability matrix and shows the feature as unavailable. Consequential actions require a bounded server command validating actor, scope, state transition, idempotency, and audit evidence before implementation.