{"id":19250062,"url":"https://github.com/persephonepunch/shopifydropship","last_synced_at":"2026-05-06T00:06:16.334Z","repository":{"id":141992517,"uuid":"490706225","full_name":"persephonepunch/shopifydropship","owner":"persephonepunch","description":"Next JS with Shopify / Twitter  Sanity backend","archived":false,"fork":false,"pushed_at":"2022-05-11T10:51:57.000Z","size":2583,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-23T16:33:35.754Z","etag":null,"topics":["api","nextjs","sanity","tailwind","webflow"],"latest_commit_sha":null,"homepage":"https://dropship-ysl.netlify.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/persephonepunch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-10T13:21:29.000Z","updated_at":"2024-01-26T02:36:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"22d5d640-9b79-4fcb-8573-fb177d8f1a78","html_url":"https://github.com/persephonepunch/shopifydropship","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/persephonepunch/shopifydropship","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/persephonepunch%2Fshopifydropship","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/persephonepunch%2Fshopifydropship/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/persephonepunch%2Fshopifydropship/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/persephonepunch%2Fshopifydropship/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/persephonepunch","download_url":"https://codeload.github.com/persephonepunch/shopifydropship/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/persephonepunch%2Fshopifydropship/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32672688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","nextjs","sanity","tailwind","webflow"],"created_at":"2024-11-09T18:16:06.705Z","updated_at":"2026-05-06T00:06:16.321Z","avatar_url":"https://github.com/persephonepunch.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003eNested Next JS \u003c/h1\u003e\nReasons to utilize separate methods\n\n- Design and Editing Layer - includes font CDN and Design/Symbol publishing\n- Security - includes entitlement login retrieval user tagging/hook automation\n- Non Destructive Publishing with multiple stream to multiple dev/prod/staging AGILE code bases\n- Separation of PCI/HIPAA data workstreams from editorial content\n- Forms and functions \n- SEO and image optimization after compile and publish\n\n\n\u003ch1\u003eWebflow to Next JS converter\u003c/h1\u003e\n\n```sh\nhttps://designsync.app/\n```\n\n\nNext JS API hooked workflow\n\nTwitter/Shopify APIs\n\nSanity\n\n\n# Sanity Studio for Shopify Projects\n\n\u003cp\u003e\u003cimg src=\"https://user-images.githubusercontent.com/209129/141306762-2cd2c6a1-2016-4a0c-b3a4-b0c8ff114625.png\" width=\"800\" /\u003e\u003c/p\u003e\n\n- [About](#about)\n- [Features](#features)\n  - [Shopify friendly content schemas](#shopify-friendly-content-schemas)\n  - [Desk structure](#desk-structure)\n  - [Custom document actions](#custom-document-actions)\n  - [Delete product and variants](#delete-product-and-variants)\n  - [Edit in Shopify shortcut](#edit-in-shopify-shortcut)\n  - [Bundled custom input components](#bundled-custom-input-components)\n- [Assumptions](#assumptions)\n- [Setup](#setup)\n- [Local Development](#local-development)\n  - [Starting development server](#starting-development-server)\n  - [Deploying the studio](#deploying-the-studio)\n  - [Upgrading Sanity Studio](#upgrading-sanity-studio)\n- [License](#license)\n\n## About\n\nThis Sanity Studio is configured for headless Shopify projects that use the official [Sanity Connect app][sanity-shopify]. It will let you augment extend product information with additional content, as well as integrate products with editoral content. This studio also contains example of customization of your [desk structure][desk-structure], [document actions][document-actions], as well as [input components][input-components].\n\nThis studio can be used with our [Hydrogen starter][hydrogen-demo], your own frontend, or anywhere else you want your e-commerce content to go.\n\n## Features\n\n### Shopify friendly content schemas\n\nThis studio is built to accommodate product information coming from a Shopify Store. You can use the official [Sanity Connect app on Shopify][sanity-shopify] to sync your product information, add content on top of it and integrate with editorial content. All your data will be available over APIs that you can access with [`@sanity/client`][sanity-client] or the [HTTP API][http-api-docs]. If you're using Hydrogen, there's also an [official plugin][hydrogen-plugin] available.\n\nInside `/schemas` you'll find schema definitions for all the content types. They are organized in folders:\n\n- `/schemas/annotations/`: Annotations let editors mark up inline text in the block content editor with rich objects. These can be used to agument editorial content with product information. It also uses referential integrity to keep you from unwillingly delete a product that's used in editorial content.\n- `/schemas/documents/`: Document types determines the shape of the JSON documents that's stored in your content lake. This is where you define the content forms for things like products, collections, variants, as well as articles.\n- `/schemas/objects/`: General purpose \u0026 re-usable content structures, such as links (`linkExternal`, `linkInternal`), `productOption` and `blockImage`.\n\n### Desk structure\n\nSanity Studio will automatically list all your [document types][document-types] out of the box. Sometimes you want a more streamlined editor experience. That's why you'll find a custom [desk-structure][desk-structure] that's defined in `/deskStructure.js`. It does the following things:\n\n- Groups product information and variants by individual products for more convenient editing\n- Creates a singleton document for controlling a homepage with featured products and collections, and a gallery\n- Creates a singleton document for settings to control naviagation and global content\n- Lists article types for information and for editorial content\n\n### Custom document actions\n\nCustom document actions let you override the default behavior of the publish button. The included document actions adds to the menu that you can find by pushing the chevron right to a document's publish button.\n\nYou can find these in `/documentActions/`.\n\nRead more about [document actions][document-actions].\n\n#### Delete product and variants\n\n`/documentActions/deleteProductAndVariants.tsx`\n\nDelete a product document including all its associated variants in your Sanity Content Lake. Without this document action, one would have to delete all variant document one-by-one.\n\n\u003cdetails\u003e\u003csummary\u003ePreview\u003c/summary\u003e\u003cimg src=\"https://user-images.githubusercontent.com/209129/141300139-00fe450b-bfcc-44f5-84d8-cd0fe0d29e10.png\" width=\"500\" /\u003e\u003c/details\u003e\n\n#### Edit in Shopify shortcut\n\n`/documentActions/shopifyLink.ts`\n\nA shortcut to edit the current product or product variant in Shopify in a new window.\n\n\u003cdetails\u003e\u003csummary\u003ePreview\u003c/summary\u003e\u003cimg src=\"https://user-imaggit ses.githubusercontent.com/209129/141300887-793de67b-4293-4a4d-b590-0a6f18b95314.png\" width=\"300\" /\u003e\u003c/details\u003e\n\n### Bundled custom input and preview components\n\n#### Placeholder string input\n\n`/components/inputs/PlaceholderString.tsx`\n\nA simple wrapper around a regular [string input](string-input) that uses the value of another field as a placeholder.\n\n\u003cdetails\u003e\u003csummary\u003eExample usage\u003c/summary\u003e\n\u003cp\u003e\n\n```javascript\n{\n  name: 'title',\n  title: 'Title',\n  type: 'placeholderString',\n  options: { field: 'store.title' }\n},\n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003ePreview\u003c/summary\u003e\u003cimg width=\"600\" src=\"https://user-images.githubusercontent.com/209129/141304183-0f31852a-d7c4-45e9-a601-2728fa87ba28.png\" /\u003e\u003c/details\u003e\n\n#### Product (and Product Variant) status\n\n`/components/inputs/ProductHidden.tsx`  \n`/components/inputs/ProductVariantHidden.tsx`\n\nDisplay-only input fields that show the corresponding product (or product variant) status in Shopify.\n\nFor instance, if it's been deleted from Shopify or has its status set to `draft` or `active`.\n\n\u003cdetails\u003e\u003csummary\u003ePreview\u003c/summary\u003e\u003cimg width=\"476\"  src=\"https://user-images.githubusercontent.com/209129/141304760-bc994315-9c76-4dcc-8f77-a8c6ff7a6fad.png\"\u003e\u003cbr /\u003e\u003cimg width=\"476\"  src=\"https://user-images.githubusercontent.com/209129/141304763-8b08d0d8-93d6-4c26-bde3-224857d45468.png\"\u003e\u003c/details\u003e\n\n#### Proxy string input\n\n`/components/inputs/ProxyString.tsx`\n\nA simple wrapper around a regular [String input field](string-input) that displays the value of another field as a read-only input.\n\nSince we are using certain product fields from Shopify as the source of truth (specifically, product title, slug and preview images) and store these in a separate `store` object, these proxy string inputs are used to better surface deeply nested fields to editors.\n\n\u003cdetails\u003e\u003csummary\u003eExample usage\u003c/summary\u003e\n\u003cp\u003e\n\n```javascript\n{\n  title: 'Slug',\n  name: 'slugProxy',\n  type: 'proxyString',\n  options: { field: 'store.slug.current' }\n}\n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003ePreview\u003c/summary\u003e\n\u003cimg width=\"600\"  src=\"https://user-images.githubusercontent.com/209129/141304625-7a5c67ca-c7f4-4644-b2b0-8d6faaadba89.png\"\u003e\n\u003c/details\u003e\n\n#### Product status (preview component)\n\n`/components/media/ProductStatus.tsx`\n\nA custom preview component that will display product and product variant images defined in `store.previewImageUrl`.\n\nBy default, Sanity Connect will populate these fields with the default product (or product variant) image from Shopify. These images are not re-uploaded into your dataset and instead reference Shopify's CDN directly.\n\nThis preview component also has visual states for when a product is _unavailable_ in Shopify (e.g. if it has a non-active status), or if it's been removed from Shopify altogether.\n\nSanity Connect will never delete your product and product variant documents.\n\n\u003cdetails\u003e\u003csummary\u003ePreview\u003c/summary\u003e\n\u003cimg width=\"320\" src=\"https://user-images.githubusercontent.com/209129/141305895-8e26700a-b48e-4809-bee7-7a52d808db6e.png\"\u003e\u003c/details\u003e\n\n### Bundled dashboard widgets\n\n\u003cp\u003e\u003cimg width=\"800\" alt=\"Shopify dashboard widgets\" src=\"https://user-images.githubusercontent.com/209129/141157755-37f4c8aa-9b1a-489e-9264-a6cacfb9a0dd.png\"\u003e\u003c/p\u003e\n\nThis studio comes preinstalled with two Shopify dashboard widgets: `shopify-connect` and `shopify-intro`, provided by the [`sanity-plugin-dashboard-widget-shopify`](https://github.com/sanity-io/sanity-plugin-dashboard-widget-shopify) plugin.\n\nThese can be configured and removed as you see fit. Please consult the plugin repo for more information.\n\n## Assumptions\n\nNo two custom storefronts are the same, and we've taken a few strong opinions with how we've approached this studio.\n\n- Synced Shopify data for `product` and `productVariant` documents are stored in a read-only object, `store`\n- Shopify is the source of truth for product titles, slugs (handles) and thumbnail images\n- Sanity is used as an additional presentational layer to add custom metadata to products\n  - This includes a portable text field, a product-level gallery and re-organisable text sections\n- Product inventory levels are not stored in Sanity\n  - However, we do store product status (whether a product is a draft, active or archived) and surface this in studio previews\n- Some images (such as product and cart line item thumbnails) are served by Shopify's CDN whilst other images (such as product-level image galleries) are handled by Sanity's Image API\n  - Similarly to product state, this is surfaced in in preview components throughout the studi\n- We only concern ourselves with incoming data from Shopify _products_ and _product variants_\n  - Other Shopify document types – such as _collections_, _pages_ and _blog posts_ are skipped and are managed independently in Sanity\n\nWe believe these rules work well for simpler use cases, and keeping product titles, images and slugs handled by Shopify helps keep content consistent as you navigate from your product views, to the cart and ultimately checkout.\n\nIt's possible that you have differing opinions on how content best be modelled to fit your particular needs – this is normal and encouraged! Fortunately, Sanity was built for this flexibility in mind, and we've written [a guide on structured content patterns of ecommerce][structured-content-patterns] which may help inform how tackle this challenge.\n\n## Setup\n\nIf you're reading this on GitHub, chances are you haven't initialized the studio locally yet. To do so, run one of these shell commands:\n\n```sh\n# run a one-off initializing script:\nnpx @sanity/cli init --template shopify\n\n# or install the Sanity CLI globally on your machine\nnpm i -g @sanity/cli \u0026\u0026 sanity init --template shopify\n```\n\n## Local Development\n\n### Starting development server\n\n```sh\nnpm start\n```\n\n### Deploying the studio\n\n```sh\nnpm run deploy\n```\n\n### Upgrading Sanity Studio\n\n```sh\nnpm run upgrade\n```\n\nIf you have the [Sanity CLI][sanity-cli] installed, you can also run thes with `sanity start|deploy|upgrade`. It comes with additional useful functionality.\n\n## License\n\nThis repository is published under the [MIT](license) license.\n\n[custom-input-components]: https://www.sanity.io/docs/custom-input-components\n[desk-structure]: https://www.sanity.io/docs/structure-builder\n[document-actions]: https://www.sanity.io/docs/custom–document-actions\n[document-types]: https://www.sanity.io/docs/\n[input-components]: https://www.sanity.io/docs/custom-input-widgets\n[http-api-docs]: https://www.sanity.io/docs/http-api\n[hydrogen-demo]: https://github.com/sanity-io/hydrogen-sanity-demo\n[hydrogen-plugin]: https://www.npmjs.com/package/@shopify/hydrogen-plugin-sanity\n[license]: https://github.com/sanity-io/sanity/blob/next/LICENSE\n[sanity-cli]: https://www.sanity.io/docs/cli\n[sanity-client]: https://www.sanity.io/docs/js-client\n[sanity-shopify]: https://apps.shopify.com/sanity-connect\n[structured-content-patterns]: https://www.sanity.io/guides/structured-content-patterns-for-e-commerce\n[string-input]: https://www.sanity.io/docs/string-type\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpersephonepunch%2Fshopifydropship","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpersephonepunch%2Fshopifydropship","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpersephonepunch%2Fshopifydropship/lists"}