From 0218f3da4fbf3fb682f98acc30d87a9e1edf1933 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Sat, 8 Aug 2026 22:42:16 +0800
Subject: [PATCH 1/2] feat(create-rstack): add Preact app templates

---
 packages/create-rstack/src/index.ts           |  3 ++
 .../template-app-preact-js/AGENTS.md          | 15 ++++++++++
 .../template-app-preact-js/package.json       | 25 +++++++++++++++++
 .../template-app-preact-js/rstack.config.js   | 25 +++++++++++++++++
 .../template-app-preact-js/src/App.css        | 26 +++++++++++++++++
 .../template-app-preact-js/src/App.jsx        | 12 ++++++++
 .../template-app-preact-js/src/index.jsx      |  4 +++
 .../tests/index.test.jsx                      |  8 ++++++
 .../tests/rstest.setup.js                     |  4 +++
 .../template-app-preact-ts/AGENTS.md          | 15 ++++++++++
 .../template-app-preact-ts/package.json       | 27 ++++++++++++++++++
 .../template-app-preact-ts/rstack.config.ts   | 25 +++++++++++++++++
 .../template-app-preact-ts/src/App.css        | 26 +++++++++++++++++
 .../template-app-preact-ts/src/App.tsx        | 12 ++++++++
 .../template-app-preact-ts/src/index.tsx      |  7 +++++
 .../tests/index.test.tsx                      |  8 ++++++
 .../tests/rstest.setup.ts                     |  4 +++
 .../tests/tsconfig.json                       |  7 +++++
 .../template-app-preact-ts/tsconfig.json      | 28 +++++++++++++++++++
 packages/create-rstack/tests/create.test.ts   | 14 ++++++++++
 20 files changed, 295 insertions(+)
 create mode 100644 packages/create-rstack/template-app-preact-js/AGENTS.md
 create mode 100644 packages/create-rstack/template-app-preact-js/package.json
 create mode 100644 packages/create-rstack/template-app-preact-js/rstack.config.js
 create mode 100644 packages/create-rstack/template-app-preact-js/src/App.css
 create mode 100644 packages/create-rstack/template-app-preact-js/src/App.jsx
 create mode 100644 packages/create-rstack/template-app-preact-js/src/index.jsx
 create mode 100644 packages/create-rstack/template-app-preact-js/tests/index.test.jsx
 create mode 100644 packages/create-rstack/template-app-preact-js/tests/rstest.setup.js
 create mode 100644 packages/create-rstack/template-app-preact-ts/AGENTS.md
 create mode 100644 packages/create-rstack/template-app-preact-ts/package.json
 create mode 100644 packages/create-rstack/template-app-preact-ts/rstack.config.ts
 create mode 100644 packages/create-rstack/template-app-preact-ts/src/App.css
 create mode 100644 packages/create-rstack/template-app-preact-ts/src/App.tsx
 create mode 100644 packages/create-rstack/template-app-preact-ts/src/index.tsx
 create mode 100644 packages/create-rstack/template-app-preact-ts/tests/index.test.tsx
 create mode 100644 packages/create-rstack/template-app-preact-ts/tests/rstest.setup.ts
 create mode 100644 packages/create-rstack/template-app-preact-ts/tests/tsconfig.json
 create mode 100644 packages/create-rstack/template-app-preact-ts/tsconfig.json

diff --git a/packages/create-rstack/src/index.ts b/packages/create-rstack/src/index.ts
index d2b0d97..079141e 100644
--- a/packages/create-rstack/src/index.ts
+++ b/packages/create-rstack/src/index.ts
@@ -74,6 +74,7 @@ const getTemplateName = async ({ template }: Argv): Promise<string> => {
           ? [
               { value: 'vanilla', label: 'Vanilla' },
               { value: 'react', label: 'React' },
+              { value: 'preact', label: 'Preact' },
               { value: 'vue', label: 'Vue' },
               { value: 'svelte', label: 'Svelte' },
               { value: 'solid', label: 'Solid' },
@@ -108,6 +109,8 @@ await create({
     'app-vanilla-ts',
     'app-react-js',
     'app-react-ts',
+    'app-preact-js',
+    'app-preact-ts',
     'app-vue-js',
     'app-vue-ts',
     'app-svelte-js',
diff --git a/packages/create-rstack/template-app-preact-js/AGENTS.md b/packages/create-rstack/template-app-preact-js/AGENTS.md
new file mode 100644
index 0000000..1de123b
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/AGENTS.md
@@ -0,0 +1,15 @@
+# AGENTS.md
+
+## Commands
+
+- `{{ packageManager }} run dev` - Start the development server
+- `{{ packageManager }} run build` - Build the app for production
+- `{{ packageManager }} run preview` - Preview the production build locally
+- `{{ packageManager }} run test` - Run tests
+- `{{ packageManager }} run test:watch` - Run tests in watch mode
+
+## Docs
+
+- Rsbuild: https://rsbuild.rs/llms.txt
+- Rspack: https://rspack.rs/llms.txt
+- Rstest: https://rstest.rs/llms.txt
diff --git a/packages/create-rstack/template-app-preact-js/package.json b/packages/create-rstack/template-app-preact-js/package.json
new file mode 100644
index 0000000..99faa0f
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/package.json
@@ -0,0 +1,25 @@
+{
+  "name": "rstack-app-preact-js",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "rs build",
+    "dev": "rs dev",
+    "format": "rs fmt",
+    "lint": "rs lint",
+    "preview": "rs preview",
+    "test": "rs test",
+    "test:watch": "rs test --watch"
+  },
+  "dependencies": {
+    "preact": "^10.29.8"
+  },
+  "devDependencies": {
+    "@rsbuild/plugin-preact": "^2.0.0",
+    "@testing-library/jest-dom": "^7.0.0",
+    "@testing-library/preact": "^3.2.4",
+    "happy-dom": "^20.11.1",
+    "rstack": "^0.3.5"
+  }
+}
diff --git a/packages/create-rstack/template-app-preact-js/rstack.config.js b/packages/create-rstack/template-app-preact-js/rstack.config.js
new file mode 100644
index 0000000..c3c2225
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/rstack.config.js
@@ -0,0 +1,25 @@
+// @ts-check
+// Rstack configuration guide: https://rstack.rs/config
+import { define } from 'rstack';
+
+define.app(async () => {
+  const { pluginPreact } = await import('@rsbuild/plugin-preact');
+
+  return {
+    plugins: [pluginPreact()],
+  };
+});
+
+define.test({
+  setupFiles: ['./tests/rstest.setup.js'],
+});
+
+define.lint(async () => {
+  const { js, reactHooksPlugin, reactPlugin } = await import('rstack/lint');
+
+  return [
+    js.configs.recommended,
+    reactPlugin.configs.recommended,
+    reactHooksPlugin.configs.recommended,
+  ];
+});
diff --git a/packages/create-rstack/template-app-preact-js/src/App.css b/packages/create-rstack/template-app-preact-js/src/App.css
new file mode 100644
index 0000000..164c0a6
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/src/App.css
@@ -0,0 +1,26 @@
+body {
+  margin: 0;
+  color: #fff;
+  font-family: Inter, Avenir, Helvetica, Arial, sans-serif;
+  background-image: linear-gradient(to bottom, #020917, #101725);
+}
+
+.content {
+  display: flex;
+  min-height: 100vh;
+  line-height: 1.1;
+  text-align: center;
+  flex-direction: column;
+  justify-content: center;
+}
+
+.content h1 {
+  font-size: 3.6rem;
+  font-weight: 700;
+}
+
+.content p {
+  font-size: 1.2rem;
+  font-weight: 400;
+  opacity: 0.5;
+}
diff --git a/packages/create-rstack/template-app-preact-js/src/App.jsx b/packages/create-rstack/template-app-preact-js/src/App.jsx
new file mode 100644
index 0000000..6509f4f
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/src/App.jsx
@@ -0,0 +1,12 @@
+import './App.css';
+
+const App = () => {
+  return (
+    <div className="content">
+      <h1>Rstack with Preact</h1>
+      <p>Start building amazing things with Rstack.</p>
+    </div>
+  );
+};
+
+export default App;
diff --git a/packages/create-rstack/template-app-preact-js/src/index.jsx b/packages/create-rstack/template-app-preact-js/src/index.jsx
new file mode 100644
index 0000000..0fe1555
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/src/index.jsx
@@ -0,0 +1,4 @@
+import { render } from 'preact';
+import App from './App';
+
+render(<App />, document.getElementById('root'));
diff --git a/packages/create-rstack/template-app-preact-js/tests/index.test.jsx b/packages/create-rstack/template-app-preact-js/tests/index.test.jsx
new file mode 100644
index 0000000..77cd121
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/tests/index.test.jsx
@@ -0,0 +1,8 @@
+import { render, screen } from '@testing-library/preact';
+import { expect, test } from 'rstack/test';
+import App from '../src/App';
+
+test('renders the main page', () => {
+  render(<App />);
+  expect(screen.getByText('Rstack with Preact')).toBeInTheDocument();
+});
diff --git a/packages/create-rstack/template-app-preact-js/tests/rstest.setup.js b/packages/create-rstack/template-app-preact-js/tests/rstest.setup.js
new file mode 100644
index 0000000..93951b1
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-js/tests/rstest.setup.js
@@ -0,0 +1,4 @@
+import { expect } from 'rstack/test';
+import * as jestDomMatchers from '@testing-library/jest-dom/matchers';
+
+expect.extend(jestDomMatchers);
diff --git a/packages/create-rstack/template-app-preact-ts/AGENTS.md b/packages/create-rstack/template-app-preact-ts/AGENTS.md
new file mode 100644
index 0000000..1de123b
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/AGENTS.md
@@ -0,0 +1,15 @@
+# AGENTS.md
+
+## Commands
+
+- `{{ packageManager }} run dev` - Start the development server
+- `{{ packageManager }} run build` - Build the app for production
+- `{{ packageManager }} run preview` - Preview the production build locally
+- `{{ packageManager }} run test` - Run tests
+- `{{ packageManager }} run test:watch` - Run tests in watch mode
+
+## Docs
+
+- Rsbuild: https://rsbuild.rs/llms.txt
+- Rspack: https://rspack.rs/llms.txt
+- Rstest: https://rstest.rs/llms.txt
diff --git a/packages/create-rstack/template-app-preact-ts/package.json b/packages/create-rstack/template-app-preact-ts/package.json
new file mode 100644
index 0000000..bfd249f
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/package.json
@@ -0,0 +1,27 @@
+{
+  "name": "rstack-app-preact-ts",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "rs build",
+    "dev": "rs dev",
+    "format": "rs fmt",
+    "lint": "rs lint",
+    "preview": "rs preview",
+    "test": "rs test",
+    "test:watch": "rs test --watch"
+  },
+  "dependencies": {
+    "preact": "^10.29.8"
+  },
+  "devDependencies": {
+    "@rsbuild/plugin-preact": "^2.0.0",
+    "@testing-library/jest-dom": "^7.0.0",
+    "@testing-library/preact": "^3.2.4",
+    "@types/node": "^24.13.3",
+    "happy-dom": "^20.11.1",
+    "rstack": "^0.3.5",
+    "typescript": "^7.0.2"
+  }
+}
diff --git a/packages/create-rstack/template-app-preact-ts/rstack.config.ts b/packages/create-rstack/template-app-preact-ts/rstack.config.ts
new file mode 100644
index 0000000..f3a2277
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/rstack.config.ts
@@ -0,0 +1,25 @@
+// Rstack configuration guide: https://rstack.rs/config
+import { define } from 'rstack';
+
+define.app(async () => {
+  const { pluginPreact } = await import('@rsbuild/plugin-preact');
+
+  return {
+    plugins: [pluginPreact()],
+  };
+});
+
+define.test({
+  setupFiles: ['./tests/rstest.setup.ts'],
+});
+
+define.lint(async () => {
+  const { js, ts, reactHooksPlugin, reactPlugin } = await import('rstack/lint');
+
+  return [
+    js.configs.recommended,
+    ts.configs.recommended,
+    reactPlugin.configs.recommended,
+    reactHooksPlugin.configs.recommended,
+  ];
+});
diff --git a/packages/create-rstack/template-app-preact-ts/src/App.css b/packages/create-rstack/template-app-preact-ts/src/App.css
new file mode 100644
index 0000000..164c0a6
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/src/App.css
@@ -0,0 +1,26 @@
+body {
+  margin: 0;
+  color: #fff;
+  font-family: Inter, Avenir, Helvetica, Arial, sans-serif;
+  background-image: linear-gradient(to bottom, #020917, #101725);
+}
+
+.content {
+  display: flex;
+  min-height: 100vh;
+  line-height: 1.1;
+  text-align: center;
+  flex-direction: column;
+  justify-content: center;
+}
+
+.content h1 {
+  font-size: 3.6rem;
+  font-weight: 700;
+}
+
+.content p {
+  font-size: 1.2rem;
+  font-weight: 400;
+  opacity: 0.5;
+}
diff --git a/packages/create-rstack/template-app-preact-ts/src/App.tsx b/packages/create-rstack/template-app-preact-ts/src/App.tsx
new file mode 100644
index 0000000..6509f4f
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/src/App.tsx
@@ -0,0 +1,12 @@
+import './App.css';
+
+const App = () => {
+  return (
+    <div className="content">
+      <h1>Rstack with Preact</h1>
+      <p>Start building amazing things with Rstack.</p>
+    </div>
+  );
+};
+
+export default App;
diff --git a/packages/create-rstack/template-app-preact-ts/src/index.tsx b/packages/create-rstack/template-app-preact-ts/src/index.tsx
new file mode 100644
index 0000000..c2c9df7
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/src/index.tsx
@@ -0,0 +1,7 @@
+import { render } from 'preact';
+import App from './App';
+
+const root = document.getElementById('root');
+if (root) {
+  render(<App />, root);
+}
diff --git a/packages/create-rstack/template-app-preact-ts/tests/index.test.tsx b/packages/create-rstack/template-app-preact-ts/tests/index.test.tsx
new file mode 100644
index 0000000..77cd121
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/tests/index.test.tsx
@@ -0,0 +1,8 @@
+import { render, screen } from '@testing-library/preact';
+import { expect, test } from 'rstack/test';
+import App from '../src/App';
+
+test('renders the main page', () => {
+  render(<App />);
+  expect(screen.getByText('Rstack with Preact')).toBeInTheDocument();
+});
diff --git a/packages/create-rstack/template-app-preact-ts/tests/rstest.setup.ts b/packages/create-rstack/template-app-preact-ts/tests/rstest.setup.ts
new file mode 100644
index 0000000..93951b1
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/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);
diff --git a/packages/create-rstack/template-app-preact-ts/tests/tsconfig.json b/packages/create-rstack/template-app-preact-ts/tests/tsconfig.json
new file mode 100644
index 0000000..3eb5dc1
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/tests/tsconfig.json
@@ -0,0 +1,7 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "types": ["rstack/types", "node", "@testing-library/jest-dom"]
+  },
+  "include": ["./"]
+}
diff --git a/packages/create-rstack/template-app-preact-ts/tsconfig.json b/packages/create-rstack/template-app-preact-ts/tsconfig.json
new file mode 100644
index 0000000..54f737f
--- /dev/null
+++ b/packages/create-rstack/template-app-preact-ts/tsconfig.json
@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "lib": ["DOM", "ES2020"],
+    "jsx": "react-jsx",
+    "target": "ES2020",
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["rstack/types", "node"],
+    "jsxImportSource": "preact",
+    "useDefineForClassFields": true,
+
+    /* modules */
+    "moduleDetection": "force",
+    "moduleResolution": "bundler",
+    "verbatimModuleSyntax": true,
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "paths": {
+      "react": ["./node_modules/preact/compat/"],
+      "react-dom": ["./node_modules/preact/compat/"]
+    },
+
+    /* type checking */
+    "noUnusedLocals": true,
+    "noUnusedParameters": true
+  },
+  "include": ["src"]
+}
diff --git a/packages/create-rstack/tests/create.test.ts b/packages/create-rstack/tests/create.test.ts
index ec3b507..c2ddf2b 100644
--- a/packages/create-rstack/tests/create.test.ts
+++ b/packages/create-rstack/tests/create.test.ts
@@ -61,6 +61,20 @@ test.each([
     testFile: 'index.test.tsx',
     hasTypeScript: true,
   },
+  {
+    template: 'app-preact-js',
+    configExtension: 'js',
+    sourceExtension: 'jsx',
+    testFile: 'index.test.jsx',
+    hasTypeScript: false,
+  },
+  {
+    template: 'app-preact-ts',
+    configExtension: 'ts',
+    sourceExtension: 'tsx',
+    testFile: 'index.test.tsx',
+    hasTypeScript: true,
+  },
   {
     template: 'app-vue-js',
     configExtension: 'js',

From 3c43db1c4a30af79d706ab7fc38b91e43770ab7b Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Sun, 9 Aug 2026 07:52:00 +0800
Subject: [PATCH 2/2] docs(create-rstack): document Preact templates

---
 packages/create-rstack/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/create-rstack/README.md b/packages/create-rstack/README.md
index 08d9d8d..b8bbd02 100644
--- a/packages/create-rstack/README.md
+++ b/packages/create-rstack/README.md
@@ -25,6 +25,8 @@ npx create-rstack -d my-project -t app-vanilla-ts
 - `app-vanilla-ts` - TypeScript Vanilla application
 - `app-react-js` - JavaScript React application
 - `app-react-ts` - TypeScript React application
+- `app-preact-js` - JavaScript Preact application
+- `app-preact-ts` - TypeScript Preact application
 - `app-vue-js` - JavaScript Vue application
 - `app-vue-ts` - TypeScript Vue application
 - `app-svelte-js` - JavaScript Svelte application