feat(create-rstack): add Turborepo template (#466)

Author: chenjiahan

packages/create-rstack/README.md

@@ -50,6 +50,7 @@ npx create-rstack --dir my-project --template app-vanilla-ts --no-git
 - `lib-solid-ts` - TypeScript Solid library
 - `doc` - Basic documentation site
 - `doc-i18n` - Multilingual documentation site
+- `turborepo` - Turborepo
 
 ## Documentation
 

packages/create-rstack/src/index.ts

@@ -8,6 +8,7 @@ import {
 import {
   access,
   appendFile,
+  copyFile,
   mkdir,
   readFile,
   writeFile,
@@ -43,6 +44,7 @@ const templateNames = [
   'lib-solid-ts',
   'doc',
   'doc-i18n',
+  'turborepo',
 ];
 
 const resolveTemplateName = (template: string): string => {
@@ -55,7 +57,7 @@ const resolveTemplateName = (template: string): string => {
 
 const getTemplateName = async ({ template }: Argv): Promise<string> => {
   if (typeof template === 'string') {
-    if (/^(?:app|lib|doc)(?:-|$)/u.test(template)) {
+    if (/^(?:app|lib|doc|turborepo)(?:-|$)/u.test(template)) {
       return resolveTemplateName(template);
     }
 
@@ -69,10 +71,22 @@ const getTemplateName = async ({ template }: Argv): Promise<string> => {
         { value: 'app', label: 'Web Application' },
         { value: 'lib', label: 'Library' },
         { value: 'doc', label: 'Documentation' },
+        { value: 'monorepo', label: 'Monorepo' },
       ],
     }),
   );
 
+  if (projectType === 'monorepo') {
+    const monorepoType = checkCancel<string>(
+      await select({
+        message: 'Select monorepo tool',
+        options: [{ value: 'turborepo', label: 'Turborepo', hint: 'pnpm' }],
+      }),
+    );
+
+    return resolveTemplateName(monorepoType);
+  }
+
   if (projectType === 'doc') {
     const documentationType = checkCancel<string>(
       await select({
@@ -215,11 +229,29 @@ const injectStagedSetup = async ({
   ]);
 };
 
+const configureTurborepo = async ({
+  templateName,
+  distFolder,
+}: GitResolvedContext): Promise<void> => {
+  if (templateName !== 'turborepo') {
+    return;
+  }
+
+  // The toolkit may skip this file based on the invoking package manager.
+  await copyFile(
+    path.join(packageRoot, 'template-turborepo/pnpm-workspace.yaml'),
+    path.join(distFolder, 'pnpm-workspace.yaml'),
+  );
+};
+
 await create({
   root: packageRoot,
   name: 'rstack',
   templates: templateNames,
   builtinTools: [],
   getTemplateName,
-  onGitResolved: injectStagedSetup,
+  onGitResolved: async (context) => {
+    await configureTurborepo(context);
+    await injectStagedSetup(context);
+  },
 });

packages/create-rstack/template-turborepo/README.md

@@ -0,0 +1,31 @@
+# Rstack + Turborepo
+
+## Setup
+
+```bash
+pnpm install
+```
+
+## Structure
+
+- `apps/web`: React application.
+- `packages/ui`: Shared UI components.
+- `packages/tsconfig`: Shared TypeScript configuration.
+
+## Scripts
+
+Run from the repository root:
+
+- `pnpm run build`: Build all packages.
+- `pnpm run dev`: Start development.
+- `pnpm run test`: Run tests.
+- `pnpm run check`: Run lint, formatting, and TypeScript checks.
+- `pnpm run lint`: Lint the workspace.
+- `pnpm run format`: Format the workspace.
+
+Run `pnpm run build` before `pnpm run check`.
+
+## Learn more
+
+- [Rstack CLI monorepo guide](https://rstack.rs/guide/monorepo)
+- [Turborepo documentation](https://turborepo.com/docs)

packages/create-rstack/template-turborepo/apps/web/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "web",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "rs build",
+    "dev": "rs dev",
+    "preview": "rs preview",
+    "test": "rs test"
+  },
+  "dependencies": {
+    "@repo/ui": "workspace:^",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8"
+  },
+  "devDependencies": {
+    "@repo/tsconfig": "workspace:^",
+    "@rsbuild/plugin-react": "^2.1.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "happy-dom": "^20.13.2"
+  }
+}

packages/create-rstack/template-turborepo/apps/web/rstack.config.ts

@@ -0,0 +1,15 @@
+// Configuration guide: https://rstack.rs/config
+import { define } from 'rstack';
+
+define.app(async () => {
+  const { pluginReact } = await import('@rsbuild/plugin-react');
+  return {
+    plugins: [pluginReact()],
+    html: { title: 'Web | Rstack' },
+    server: { port: 3000 },
+  };
+});
+
+define.test({
+  setupFiles: ['./tests/rstest.setup.ts'],
+});

packages/create-rstack/template-turborepo/apps/web/src/App.tsx

@@ -0,0 +1,17 @@
+import { Button } from '@repo/ui/button';
+
+export function App() {
+  return (
+    <main>
+      <h1>Web</h1>
+      <p>Turborepo + Rstack CLI</p>
+      <p>Edit apps/web/src/App.tsx to get started.</p>
+      <Button onClick={() => window.alert('Hello from @repo/ui!')}>
+        Shared button
+      </Button>
+      <nav>
+        <a href="https://rstack.rs">Rstack documentation</a>
+      </nav>
+    </main>
+  );
+}

packages/create-rstack/template-turborepo/apps/web/src/index.css

@@ -0,0 +1,27 @@
+body {
+  margin: 0;
+  font-family: system-ui, sans-serif;
+  color: #202124;
+  background: #f8f9fa;
+}
+
+main {
+  max-width: 640px;
+  margin: 15vh auto;
+  padding: 24px;
+}
+
+button {
+  padding: 10px 16px;
+  border: 0;
+  border-radius: 8px;
+  color: white;
+  background: #5755d9;
+  cursor: pointer;
+}
+
+nav {
+  display: flex;
+  gap: 20px;
+  margin-top: 24px;
+}

packages/create-rstack/template-turborepo/apps/web/src/index.tsx

@@ -0,0 +1,13 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { App } from './App';
+import './index.css';
+
+const root = document.getElementById('root');
+if (root) {
+  createRoot(root).render(
+    <StrictMode>
+      <App />
+    </StrictMode>,
+  );
+}

packages/create-rstack/template-turborepo/apps/web/tests/app.test.tsx

@@ -0,0 +1,11 @@
+import { expect, test } from 'rstack/test';
+import { render, screen } from '@testing-library/react';
+import { App } from '../src/App';
+
+test('renders the web app with the shared UI package', () => {
+  render(<App />);
+  expect(screen.getByRole('heading', { name: 'Web' })).toBeInTheDocument();
+  expect(
+    screen.getByRole('button', { name: 'Shared button' }),
+  ).toBeInTheDocument();
+});

packages/create-rstack/template-turborepo/apps/web/tests/rstest.setup.ts

@@ -0,0 +1,4 @@
+import { expect } from 'rstack/test';
+import * as jestDomMatchers from '@testing-library/jest-dom/matchers';
+
+expect.extend(jestDomMatchers);