GatsbyReact电商启动器

storefront-gatsby-starter — Gatsby 电商模板

作者 vendurehq

基于 Gatsby 构建的 Vendure 电商店面启动器，通过环境变量连接 Vendure Shop API，购物车、结账、搜索筛选与账户管理仍列在待办清单中。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

2 个预览视图
桌面端首页1 / 2
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 2

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-02查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

使用 Gatsby 构建的 Vendure 店面启动器，由 Vendure 官方组织维护

02

通过 GATSBY_VENDURE_SHOP_API_URL 环境变量连接 Vendure Shop API，可指向演示服务或本地服务

03

要求后端使用 bearer token，本地 Vendure 需将 apiOptions.tokenMethod 配置为 'bearer' 或 ['bearer', 'cookie']

04

README 将购物车、结账流程、搜索分面筛选、客户账户管理列为待办功能

05

采用 MIT 许可，提供 Netlify 演示站点与桌面、手机端首页截图

模板详细介绍

这是一个面向 Vendure 的店面启动器，使用 Gatsby 作为前端框架，仓库由 Vendure 官方组织维护，采用 MIT 许可。项目通过环境变量 GATSBY_VENDURE_SHOP_API_URL 指定后端 Shop API 地址，既可以指向官方只读演示服务，也可以指向本地运行的 Vendure 服务。README 明确说明该店面依赖 bearer token，因此本地 Vendure 服务需要把 apiOptions.tokenMethod 设为 'bearer' 或 ['bearer', 'cookie']。

项目当前处于早期阶段。README 的 To do 列表列出购物车、结账流程、搜索分面筛选和客户账户管理四项尚未完成的功能，说明这些电商核心能力在仓库中并不完整。仓库提供 Netlify 演示站点，并附有桌面端与手机端首页截图。

开发流程为：安装依赖、创建 .env.development 并写入 API 地址、运行 npm run develop。仓库最后更新时间为 2022 年，star 数较少，适合作为了解 Gatsby 与 Vendure 组合方式的起点，而不是可直接上线的完整店铺。

Gatsby电商启动器

适合你的项目吗？

适用场景

  • 在本地启动 Vendure 服务并接入该店面，验证 Gatsby 与 Vendure Shop API 的对接方式
  • 以官方只读演示 API 为后端，快速查看店面前端的页面结构与视觉呈现
  • 作为二次开发的起点，在现有代码基础上补充购物车、结账、搜索筛选或账户管理功能
  • 用于学习 Gatsby 项目如何通过环境变量配置外部电商 API 地址

适合人群

  • 希望了解 Gatsby 与 Vendure 组合方式的开发者
  • 需要以 MIT 许可代码为基础自行扩展电商功能的团队
  • 计划在本地搭建 Vendure 服务并配套前端店面的开发者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    运行 npm install 安装依赖

  2. 2

    创建 .env.development 文件，写入 GATSBY_VENDURE_SHOP_API_URL，可设为 https://readonlydemo.vendure.io/shop-api 或本地地址 http://localhost:3000/shop-api

  3. 3

    若使用本地 Vendure 服务，需将 apiOptions.tokenMethod 设为 'bearer' 或 ['bearer', 'cookie']，该店面依赖 bearer token

  4. 4

    运行 npm run develop 启动开发环境

  5. 5

    README 列出的购物车、结账、搜索筛选与账户管理功能尚未实现，使用前需自行确认代码现状

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 需自行配置环境变量 GATSBY_VENDURE_SHOP_API_URL 指向 Vendure Shop API；默认示例指向官方只读演示服务，仅可读取，不能用于真实交易。
  • 使用本地 Vendure 服务时，必须将后端 apiOptions.tokenMethod 设为 'bearer' 或 ['bearer','cookie']，该店面依赖 bearer token，否则无法正常对接。
  • 购物车、结账流程、搜索分面筛选与客户账户管理均列在待办清单中，尚未实现，不能作为完整可上线的电商店面使用。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

GATSBY_VENDURE_SHOP_API_URL=https://readonlydemo.vendure.io/shop-api

README 原文

If using local Vendure server, ensure you have `apiOptions.tokenMethod` set to `'bearer'` or `['bearer', 'cookie']` - this storefront requires bearer tokens.

README 原文

* Cart * Checkout flow * Search facet filters * Customer account management

README 原文
https://github.com/vendurehq/storefront-gatsby-starter/blob/master/LICENSEhttps://github.com/vendurehq/storefront-gatsby-starter/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-02。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料一般 · 73 / 100
技术栈
Gatsby · React
网站类型
电商 · 启动器
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2022-04-15
截图检查日期
2026-10-02

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Gatsby。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: fdaf2ae69ee295059a24a8d60de012456fd2c15f9e43fc8170b241b1262ba8b5

2026-10-02T07:36:52.616Z

来源文件 / 仓库
# Vendure Gatsby Storefront Starter

A storefront for [Vendure](https://www.vendure.io/) built with [Gatsby](https://www.gatsbyjs.com/).

## To do:

* Cart
* Checkout flow
* Search facet filters
* Customer account management

**Contributions welcome!**

## Development

1. `npm install`
2. Create an `.env.development` file defining the following environment variables:
   ```
   GATSBY_VENDURE_SHOP_API_URL=https://readonlydemo.vendure.io/shop-api
   # or
   GATSBY_VENDURE_SHOP_API_URL=http://localhost:3000/shop-api
   ```
3. If using local Vendure server, ensure you have `apiOptions.tokenMethod` set to `'bearer'` or `['bearer', 'cookie']` - this storefront requires bearer tokens.
4. `npm run develop`
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

gatsby-starter-gcn

gatsby-starter-gcn

gatsby-starter-gcn 是一个面向静态网站构建的 Gatsby 启动器，将内容管理、部署和前端开发串联起来。

Gatsby · 博客

gatsby-starter-morning-dew

gatsby-starter-morning-dew

:rocket: A Gatsby theme/starter to build lightning-fast blog/websites

Gatsby · 博客

starter-gatsby-blog

starter-gatsby-blog

这是一个由 Contentful 社区维护的 Gatsby 博客启动器，目标是把静态站点的低维护成本与 Contentful 的友好编辑界面结合起来。

Gatsby · 社区

automatic-gatsbyjs-app-landing-page

automatic-gatsbyjs-app-landing-page

Automatic GatsbyJS App Landing Page - Automatically generate iOS app landing page using GatsbyJS

Gatsby · 工具站

gatsby-starter-cv

gatsby-starter-cv

A simple starter to get up and developing your digital curriculum with GatsbyJS

Gatsby · 启动器

clay-theme

clay-theme

Image-centric Gatsby theme for publishers, portfolios, photographers blogs and more.

Gatsby · 作品集