feat: release v4

.env

@@ -1,13 +1,9 @@
-# ReactPress — copy to .env and run `pnpm init` to sync from .reactpress/config.json
+# ReactPress — managed by reactpress-cli
 DB_HOST=127.0.0.1
-DB_PORT=3306
+DB_PORT=3307
 DB_USER=reactpress
 DB_PASSWD=reactpress
 DB_DATABASE=reactpress
-
-
-# Client Config
 CLIENT_SITE_URL=http://localhost:3001
-
-# Server Config
-SERVER_SITE_URL=http://localhost:3002
+SERVER_SITE_URL=http://localhost:3002
+SERVER_PORT=3002

.eslintrc.js

@@ -7,19 +7,63 @@ module.exports = {
     'plugin:@typescript-eslint/recommended',
     'plugin:prettier/recommended',
   ],
+  parserOptions: {
+    sourceType: 'module',
+    ecmaVersion: 'latest',
+  },
   overrides: [
     {
-      files: ['**/*.{ts,tsx,js,jsx}'],
+      files: ['web/**/*.{ts,tsx}'],
+      parserOptions: {
+        project: ['./web/tsconfig.eslint.json'],
+        tsconfigRootDir: __dirname,
+      },
+    },
+    {
+      files: ['toolkit/**/*.ts'],
+      parserOptions: {
+        project: ['./toolkit/tsconfig.json'],
+        tsconfigRootDir: __dirname,
+      },
+    },
+    {
+      files: ['server/**/*.ts'],
       parserOptions: {
-        project: ['./client/tsconfig.json'],
+        project: ['./server/tsconfig.json'],
         tsconfigRootDir: __dirname,
-        sourceType: 'module',
+      },
+    },
+    {
+      files: ['docs/**/*.{ts,tsx}'],
+      parserOptions: {
+        project: ['./docs/tsconfig.eslint.json'],
+        tsconfigRootDir: __dirname,
+      },
+    },
+    {
+      files: ['themes/hello-world/**/*.{ts,tsx}'],
+      parserOptions: {
+        project: ['./themes/hello-world/tsconfig.eslint.json'],
+        tsconfigRootDir: __dirname,
+      },
+    },
+    {
+      // Next.js regenerates next-env.d.ts with /// <reference path="…" /> for route types.
+      files: ['**/next-env.d.ts'],
+      rules: {
+        '@typescript-eslint/triple-slash-reference': 'off',
       },
     },
   ],
   settings: {
     react: {
-      version: '17.0',
+      version: 'detect',
+    },
+    'import/resolver': {
+      node: {
+        paths: ['./'],
+        extensions: ['.js', '.jsx', '.ts', '.tsx'],
+      },
     },
   },
   env: {
@@ -43,12 +87,23 @@ module.exports = {
     '@typescript-eslint/explicit-module-boundary-types': 0,
     '@typescript-eslint/ban-types': 0,
     'react-hooks/rules-of-hooks': 2,
-    'react-hooks/exhaustive-deps': 2,
+    'react-hooks/exhaustive-deps': 1,
     'react/prop-types': 0,
     'react/react-in-jsx-scope': 0,
-    'prettier/prettier': 'error',
-    'simple-import-sort/imports': 'error',
-    'simple-import-sort/exports': 'error',
+    // Prettier 2.x cannot parse modern TS (`import type`, inline `type` imports).
+    // web uses `vp fmt` (Oxfmt); keep formatting out of ESLint to avoid false IDE errors.
+    'prettier/prettier': 0,
+    'simple-import-sort/imports': 'off',
+    'simple-import-sort/exports': 'off',
   },
-  ignorePatterns: ['dist/', 'node_modules', 'scripts'],
+  ignorePatterns: [
+    'dist/',
+    'node_modules',
+    'scripts',
+    'examples',
+    '**/.next',
+    'toolkit/dist',
+    'server/dist',
+    'web/src/routeTree.gen.ts',
+  ],
 };

.github/workflows/ci.yml

@@ -13,12 +13,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 9
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
           cache: pnpm
 
       - name: Install dependencies
@@ -50,22 +48,17 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 9
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
           cache: pnpm
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Build toolkit
-        run: pnpm run build:toolkit
-
-      - name: Build server
-        run: pnpm run build:server
+      - name: Production build
+        run: pnpm run build
 
       - name: Create test .env
         run: |

.github/workflows/deploy-ecs.yml

@@ -0,0 +1,110 @@
+# Build on GitHub → upload release tarball → SSH deploy on ECS.
+#
+# Required GitHub Secrets (Settings → Secrets and variables → Actions):
+#   ECS_HOST          ECS public IP or domain
+#   ECS_USER          SSH user, e.g. root or deploy
+#   ECS_SSH_KEY       Private key (PEM), full content including BEGIN/END lines
+#   ECS_APP_DIR       App root on server, e.g. /opt/reactpress
+#
+# Optional Secrets:
+#   ECS_SSH_PORT      Default 22
+#   NGINX_ENTRY_URL   Public site URL written into deploy env, e.g. https://blog.example.com
+#
+# One-time ECS setup:
+#   1. Clone repo to ECS_APP_DIR, create .env (DB, ports, domain — never commit)
+#   2. Install Node 24, pnpm, PM2, Docker; run `pnpm run deploy` once manually
+#   3. Add GitHub Actions deploy key / user SSH public key to ECS ~/.ssh/authorized_keys
+#
+name: Deploy ECS
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main, master]
+
+concurrency:
+  group: deploy-ecs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Production build + pack
+        run: pnpm run build
+
+      - name: Locate release tarball
+        id: pack
+        run: |
+          TAR="$(ls -1 dist/reactpress-release-*.tar.gz | tail -1)"
+          echo "path=$TAR" >> "$GITHUB_OUTPUT"
+          echo "name=$(basename "$TAR")" >> "$GITHUB_OUTPUT"
+
+      - name: Upload release artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: reactpress-release
+          path: ${{ steps.pack.outputs.path }}
+          retention-days: 7
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name != 'pull_request'
+    environment: production
+    steps:
+      - name: Download release artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: reactpress-release
+          path: dist
+
+      - name: Resolve tarball name
+        id: tar
+        run: |
+          TAR="$(ls -1 dist/reactpress-release-*.tar.gz | tail -1)"
+          echo "path=$TAR" >> "$GITHUB_OUTPUT"
+          echo "name=$(basename "$TAR")" >> "$GITHUB_OUTPUT"
+
+      - name: Prepare upload directory
+        run: |
+          mkdir -p upload
+          cp "${{ steps.tar.outputs.path }}" "upload/${{ steps.tar.outputs.name }}"
+
+      - name: Copy release to ECS
+        uses: appleboy/scp-action@v0.1.7
+        with:
+          host: ${{ secrets.ECS_HOST }}
+          username: ${{ secrets.ECS_USER }}
+          key: ${{ secrets.ECS_SSH_KEY }}
+          port: ${{ secrets.ECS_SSH_PORT || 22 }}
+          source: upload/${{ steps.tar.outputs.name }}
+          target: ${{ secrets.ECS_APP_DIR }}/dist/
+
+      - name: Deploy on ECS
+        uses: appleboy/ssh-action@v1.2.0
+        with:
+          host: ${{ secrets.ECS_HOST }}
+          username: ${{ secrets.ECS_USER }}
+          key: ${{ secrets.ECS_SSH_KEY }}
+          port: ${{ secrets.ECS_SSH_PORT || 22 }}
+          command_timeout: 30m
+          script: |
+            set -e
+            cd "${{ secrets.ECS_APP_DIR }}"
+            git fetch origin "${{ github.ref_name }}" --depth=1
+            git checkout "${{ github.sha }}"
+            export NGINX_ENTRY_URL="${{ secrets.NGINX_ENTRY_URL }}"
+            pnpm run deploy -- "dist/${{ steps.tar.outputs.name }}"

.github/workflows/release-package.yml

@@ -1,33 +1,30 @@
-name: Node.js Package
+name: Release
 
 on:
   release:
     types: [created]
 
 jobs:
-  build:
+  validate:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm ci
-      - run: npm test
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
 
-  publish-gpr:
-    needs: build
-    runs-on: ubuntu-latest
-    permissions:
-      packages: write
-      contents: read
-    steps:
-      - uses: actions/checkout@v5
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
-          registry-url: https://npm.pkg.github.com/
-      - run: npm ci
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
+          node-version: 24
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Production build
+        run: pnpm run build
+
+      - name: Test
+        run: pnpm test
+
+      - name: Build publishable packages
+        run: pnpm run publish:build

.gitignore

@@ -1,8 +1,17 @@
+# 官方主题模板（运行时副本在 .reactpress/runtime/，已由 .reactpress/ 忽略）
+themes/*
+!themes/hello-world/
+!themes/theme-starter/
+!themes/.gitkeep
+!themes/README.md
+
 node_modules
 .DS_Store
 .idea
 .next
+.next-preview
 .cursor
+.brand-export/
 
 .env.prod
 .reactpress/
@@ -14,16 +23,33 @@ node_modules
 sitemap.xml
 
 lib
-!cli/lib
+!cli/src/lib/
+!themes/hello-world/**/lib/
+!themes/theme-starter/**/lib/
+cli/out/
 dist
 dist-ssr
 coverage
 logs
 test-results
+web/dist
+web/playwright-report
+web/.tanstack
+
+# Electron desktop (desktop/)
+desktop/out/
+desktop/.cache/
+desktop/release/
+desktop/*.dmg
+desktop/*.zip
+desktop/*.exe
+desktop/*.AppImage
+desktop/*.blockmap
+desktop/builder-debug.yml
+desktop/builder-effective-config.yaml
+
 .pnpm-store
 tsconfig.tsbuildinfo
-.pnpm-store
-
 
 
 # Production (root output only; do not use bare `build` — toolkit/src/theme/build is source)

.npmrc

@@ -1,3 +1,3 @@
 strict-peer-dependencies=false
-engine-strict = true
+engine-strict = false
 engine=node >=18.20.4

.nvmrc

@@ -0,0 +1 @@
+22

.prettierrc

@@ -2,7 +2,7 @@
   "singleQuote": true,
   "quoteProps": "consistent",
   "bracketSpacing": true,
-  "jsxBracketSameLine": false,
+  "bracketSameLine": false,
   "arrowParens": "always",
   "trailingComma": "es5",
   "tabWidth": 2,