swyxio / sveltekit-monorepo

sveltekit + turborepo + histoire in a turborepo

swyx's SvelteKit monorepo starter

This is my starter for a monorepo with 2022 tech:

• SvelteKit
• Turborepo
• Histoire
• pnpm - brew install pnpm

Demo

Proof that this repo deploys to Netlify properly (which was way harder than it should be...)

https://sveltekit-monorepo-ui.netlify.app/

What's inside?

Apps and Packages

• Apps
  • dashboard: a SvelteKit app. This is the end product that end users should be seeing. Feel free to clone this if building more.
  • ui: a stub Svelte component library usable by the dashboard app
    • with a histoire storybook you can also run for dev, or publish
    • it is also set up for you to publish the component library with svelte-package
• Packages
  • eslint-config-custom: eslint configurations (includes eslint-config-next and eslint-config-prettier)
  • tsconfig: tsconfig.jsons used throughout the monorepo

Utilities

This turborepo has some additional tools already setup for you:

• We have opted for using jsdoc types for now, but that opinion is open for debate.
• ESLint for code linting
• Prettier for code formatting

Setup

pnpm # to install all the things

Build

To build all apps and packages, run the following command:

cd my-turborepo
pnpm run build

Develop

To develop all apps and packages, run the following command:

cd my-turborepo
pnpm run dev

Installing packages

To install a library package in the ui workspace with pnpm:

pnpm add --filter ui library

Run histoire

pnpm --filter ui story:dev

Remote Caching

Turborepo can use a technique known as Remote Caching to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.

By default, Turborepo will cache locally. To enable Remote Caching you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:

cd my-turborepo
pnpx turbo login

This will authenticate the Turborepo CLI with your Vercel account.

Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your turborepo:

pnpx turbo link

Turborepo Links

Learn more about the power of Turborepo:

• Pipelines
• Caching
• Remote Caching
• Scoped Tasks
• Configuration Options
• CLI Usage

Useful Links

• using pnpm with netlify
  • https://www.seancdavis.com/posts/use-pnpm-with-netlify/
    • but results in EEXIST: file already exists, mkdir '/dev/null' error
  • https://answers.netlify.com/t/using-pnpm-and-pnpm-workspaces/2759/19
    • not so useful
  • i think this is what solved it for me netlify/build#1633
• prior art: https://github.com/Brisklemonade/turbosvelte

sveltekit-monorepo's Issues

Tailwind and exported css

Hi,

Just wondering if you have solved things like let's say the UI project utilising the tailwind plugin and the dashboard consuming the components from UI. At lest in dev mode, I find that the dashboard project won't receive the tailwind classes until I publish the UI package to get the appropriate TW classes generated and exported.

Any ideas or pointers to how one might work around this ?

Cheers,
Nik

images