@askphill/shopify-parcel/README.md

Simple JavaScript and CSS bundling for Shopify themes with Parcel.

# Shopify Parcel

Simple JavaScript and CSS bundling for Shopify themes with Parcel.

- 🧘 **Zero configuration.** Parcel is provided sensible defaults and easily integrates with TailwindCSS, TypeScript, SCSS, and more.
- ⚡ **Instant feedback.** Thanks to our plugin and CLI, Parcel's caching and source maps, and Shopify CLI's live reload.
- 🚚 **Ready to ship.** Automatically bundle and deploy using GitHub Actions and the Shopify GitHub integration.

This CLI provides commands for [parcel-config-shopify](https://www.npmjs.com/package/@askphill/parcel-config-shopify).

## Getting started

Explore [our example theme](https://github.com/askphill/shopify-parcel-example#readme) for the optimal development setup.

- Install CLI `npm i -D shopify-parcel`
- See available commands `npx shopify-parcel`

## Configuration

Configure in `package.json#shopify-parcel`.

| Config    | Default                 | Description                                                       |
| --------- | ----------------------- | ----------------------------------------------------------------- |
| `entries` | `["src/*.{js,ts,css}"]` | Parcel [entries](https://parceljs.org/features/targets/#entries). |

## Inspiration

- This project is heavily inspired by [Shopify Vite Plugin](https://shopify-vite.barrelny.com/). Their idea of writing a plugin and using Shopify snippets was all we needed to do the same for Parcel.
- [Parcel](https://parceljs.org/) can bundle anything you feed it. Its flexibility and ease of use make it the obvious choice for us.
- The [Shopify CLI](https://shopify.dev/docs/themes/tools/cli/install) is great, and even better with Shopify Parcel. There is no need to reinvent the wheel.