openfront-dealership-custom-storefront

Plan and build custom Openfront Dealership storefronts by inspecting source code and GraphQL contracts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Customizing a dealership storefront without understanding the existing source architecture leads to broken workflows, unauthorized data access, and mismatched GraphQL contracts. This Skill guides a structured process of source orientation, user interviews, and contract inspection before any code is written. ## Core Features & Use Cases - Source Architecture Orientation: Maps the built-in storefront behavior in features/storefront, route entry points in app/**, and the server contract in features/keystone and schema.graphql. - Structured Requirements Interview: Asks targeted questions about target revision, built-in versus separate client mode, required journeys, and available test environments. - Capability Matrix & Safe Implementation: Verifies each operation against the actual schema and access rules, distinguishing presentation-only changes from backend-contract work for vehicle inventory, inquiry, finance, test-drive, trade-in, and service-request flows. - Use Case: A developer needs to rebrand a dealership storefront and add a trade-in form. The Skill inspects the real routes and GraphQL operations, confirms which flows are safe to modify, and flags anything requiring a new backend contract before implementation. ## Quick Start Use the openfront-dealership-custom-storefront skill to plan a custom storefront for my Openfront Dealership checkout at revision main.

Frequently Asked Questions about openfront-dealership-custom-storefront

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

FAQPage Schema
How do I customize an Openfront Dealership storefront?

Start by inspecting the built-in storefront in features/storefront, which defines routes, data loaders, sessions, and UI composition. Then decide whether to adapt the built-in client or build a separately deployed client, verifying every GraphQL operation against schema.graphql before changing code.

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

Adapt the built-in client when you can reuse existing sessions, transport, design tokens, and named server operations while keeping route files thin. Build a separate client when you need independent deployment, but pin the schema, use checked named operations, and never expose an arbitrary GraphQL proxy.

Can I reuse Ecommerce GraphQL queries in a Dealership storefront?

No, you must not borrow Ecommerce GraphQL roots or rename products and orders into the dealership vertical without validation. Each operation must be verified against this product's schema.graphql, model access rules, and custom resolvers to confirm it exists and is authorized.

What should I check before modifying dealership storefront code?

Enumerate the actual app routes, trace screen components and their data loaders, list GraphQL operations used, and read schema.graphql plus access rules. Record actor, tenant scope, inputs, outputs, idempotency, and error states, then produce a capability matrix before proposing changes.

Why is a schema-valid GraphQL document not enough for safe storefront access?

A schema-valid document only proves the query parses, not that the actor is authorized or the workflow is safe. Generated CRUD, HTTP 200 responses, or attractive empty states do not prove the storefront workflow is operational; access rules and lifecycle authority must be verified.