devstack 0.1.0

package/templates/base/frontend/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "include": ["**/*.ts", "**/*.tsx"],
+    "compilerOptions": {
+        "target": "ES2022",
+        "jsx": "react-jsx",
+        "module": "ESNext",
+        "lib": ["ES2022", "DOM", "DOM.Iterable"],
+        "types": ["vite/client"],
+
+        /* Bundler mode */
+        "moduleResolution": "bundler",
+        "allowImportingTsExtensions": true,
+        "verbatimModuleSyntax": true,
+        "noEmit": true,
+
+        /* Linting */
+        "skipLibCheck": true,
+        "strict": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "noUncheckedSideEffectImports": true,
+        "paths": {
+            "@/*": ["./src/*"]
+        }
+    }
+}

package/templates/base/frontend/vite.config.ts

@@ -0,0 +1,30 @@
+import babel from "@rolldown/plugin-babel";
+import tailwindcss from "@tailwindcss/vite";
+import { devtools } from "@tanstack/devtools-vite";
+import { tanstackRouter } from "@tanstack/router-plugin/vite";
+import viteReact, { reactCompilerPreset } from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+import { fileURLToPath, URL } from "node:url";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    devtools(),
+    tanstackRouter({
+      target: "react",
+      autoCodeSplitting: true,
+    }),
+    viteReact(),
+    babel({
+      presets: [reactCompilerPreset()],
+      plugins: ["@babel/plugin-syntax-jsx"],
+    }),
+    tailwindcss(),
+  ],
+  resolve: {
+    alias: {
+      "@": fileURLToPath(new URL("./src", import.meta.url)),
+    },
+  },
+});

package/templates/base/frontend/vitest.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from "vitest/config";
+import viteReact from "@vitejs/plugin-react";
+import { fileURLToPath, URL } from "node:url";
+
+export default defineConfig({
+  plugins: [viteReact()],
+  resolve: {
+    alias: {
+      "@": fileURLToPath(new URL("./src", import.meta.url)),
+    },
+  },
+  test: {
+    name: "{{projectName}}",
+    environment: "jsdom",
+    globals: true,
+    include: ["src/**/*.{test,spec}.{ts,tsx}"],
+    exclude: ["**/node_modules/**", "**/dist/**"],
+    setupFiles: ["./src/test-setup.ts"],
+  },
+});

package/templates/base/root/.editorconfig

@@ -0,0 +1,35 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+tab_width = 2
+
+# Align with oxfmt printWidth
+[*.{js,ts,jsx,tsx,json,css,scss,md}]
+max_line_length = 100
+
+# JSON files use 4 spaces
+[*.{json,jsonc}]
+indent_size = 4
+tab_width = 4
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+
+# Makefiles
+[Makefile]
+indent_style = tab
+
+# Go/Proto/Make files use tabs
+[*.{go,proto,make}]
+indent_style = tab

package/templates/base/root/.github/actions/setup-bun/action.yml

@@ -0,0 +1,48 @@
+name: "Setup Bun Environment"
+description: "Sets up Bun with caching and dependency installation for Dash projects"
+author: "Dash Team"
+
+inputs:
+  bun-version:
+    description: "Bun version to install"
+    required: false
+    default: "latest"
+  install-dependencies:
+    description: "Install dependencies with bun install"
+    required: false
+    default: "true"
+
+outputs:
+  bun-version:
+    description: "The Bun version that was installed"
+    value: ${{ steps.setup-bun.outputs.bun-version }}
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set up Bun
+      id: setup-bun
+      uses: oven-sh/setup-bun@v2
+      with:
+        bun-version: ${{ inputs.bun-version }}
+
+    - name: Cache Bun dependencies
+      uses: actions/cache@v4
+      with:
+        path: ~/.bun/install/cache
+        key: bun-${{ runner.os }}-${{ hashFiles('**/bun.lock') }}
+        restore-keys: bun-${{ runner.os }}-
+
+    - name: Install dependencies
+      if: inputs.install-dependencies == 'true'
+      shell: bash
+      run: |
+        echo "Installing dependencies with bun..."
+        bun install --frozen-lockfile
+
+    - name: Report setup status
+      shell: bash
+      run: |-
+        echo "Bun setup completed successfully!"
+        echo "Bun version: $(bun --version)"
+        echo "Dependencies installed: ${{ inputs.install-dependencies }}"

package/templates/base/root/.github/workflows/ci.yaml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  BUN_VERSION: "latest"
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  validate-title:
+    name: Validate PR Title
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          requireScope: false
+          types: |
+            build
+            ci
+            chore
+            docs
+            feat
+            fix
+            perf
+            refactor
+            revert
+            test
+
+  quality:
+    name: Quality Pipeline
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+          install-dependencies: "true"
+      - name: Validate commits
+        run: |
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            bunx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose
+          else
+            bunx commitlint --last --verbose
+          fi
+      - name: Run quality pipeline
+        run: make check

package/templates/base/root/.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+set -eu
+
+bun x --no -- commitlint --edit "$1"

package/templates/base/root/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+set -eu
+
+bun x lint-staged

package/templates/base/root/.nvmrc

@@ -0,0 +1,2 @@
+24
+

package/templates/base/root/.oxfmtrc.json

@@ -0,0 +1,33 @@
+{
+    "$schema": "./node_modules/oxfmt/configuration_schema.json",
+    "printWidth": 100,
+    "singleQuote": false,
+    "semi": true,
+    "useTabs": false,
+    "trailingComma": "es5",
+    "bracketSpacing": true,
+    "bracketSameLine": false,
+    "arrowParens": "avoid",
+    "endOfLine": "lf",
+    "editorconfig": true,
+    "ignorePatterns": [
+        "_old_project/**",
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/dist-ssr/**",
+        "**/build/**",
+        "**/out/**",
+        "**/.next/**",
+        "**/.turbo/**",
+        "**/storybook-static/**",
+        "**/coverage/**",
+        "**/.mastra/**",
+        "**/docs/.dist/**",
+        "**/*.min.js",
+        "**/*.bundle.js",
+        "**/generated/**",
+        "frontend/src/generated/**",
+        ".resources/**",
+        ".claude/skill/**"
+    ]
+}

package/templates/base/root/.oxlintrc.json

@@ -0,0 +1,179 @@
+{
+    "$schema": "./node_modules/oxlint/configuration_schema.json",
+    "plugins": ["unicorn", "typescript", "oxc"],
+    "jsPlugins": [
+        "./lint-plugins/react-component-complexity.mjs",
+        "./lint-plugins/react-hooks-separation.mjs",
+        "./lint-plugins/test-file-location.mjs"
+    ],
+    "categories": {},
+    "rules": {
+        "no-unassigned-vars": "warn",
+        "for-direction": "warn",
+        "no-async-promise-executor": "warn",
+        "no-caller": "warn",
+        "no-class-assign": "warn",
+        "no-compare-neg-zero": "warn",
+        "no-cond-assign": "warn",
+        "no-const-assign": "warn",
+        "no-constant-binary-expression": "warn",
+        "no-constant-condition": "warn",
+        "no-control-regex": "warn",
+        "no-debugger": "warn",
+        "no-delete-var": "warn",
+        "no-dupe-class-members": "warn",
+        "no-dupe-else-if": "warn",
+        "no-dupe-keys": "warn",
+        "no-duplicate-case": "warn",
+        "no-empty-character-class": "warn",
+        "no-empty-pattern": "warn",
+        "no-empty-static-block": "warn",
+        "no-eval": "warn",
+        "no-ex-assign": "warn",
+        "no-extra-boolean-cast": "warn",
+        "no-func-assign": "warn",
+        "no-global-assign": "warn",
+        "no-import-assign": "warn",
+        "no-invalid-regexp": "warn",
+        "no-irregular-whitespace": "warn",
+        "no-loss-of-precision": "warn",
+        "no-new-native-nonconstructor": "warn",
+        "no-nonoctal-decimal-escape": "warn",
+        "no-obj-calls": "warn",
+        "no-self-assign": "warn",
+        "no-setter-return": "warn",
+        "no-shadow-restricted-names": "warn",
+        "no-sparse-arrays": "warn",
+        "no-this-before-super": "warn",
+        "no-unsafe-finally": "warn",
+        "no-unsafe-negation": "warn",
+        "no-unsafe-optional-chaining": "warn",
+        "no-unused-labels": "warn",
+        "no-unused-private-class-members": "error",
+        "no-unused-vars": "error",
+        "no-unused-expressions": ["warn", { "allowTaggedTemplates": true }],
+        "no-useless-backreference": "warn",
+        "no-useless-catch": "warn",
+        "no-useless-escape": "warn",
+        "no-useless-rename": "warn",
+        "no-with": "warn",
+        "require-yield": "warn",
+        "use-isnan": "warn",
+        "valid-typeof": "warn",
+        "oxc/bad-array-method-on-arguments": "warn",
+        "oxc/bad-char-at-comparison": "warn",
+        "oxc/bad-comparison-sequence": "warn",
+        "oxc/bad-min-max-func": "warn",
+        "oxc/bad-object-literal-comparison": "warn",
+        "oxc/bad-replace-all-arg": "warn",
+        "oxc/const-comparisons": "warn",
+        "oxc/double-comparisons": "warn",
+        "oxc/erasing-op": "warn",
+        "oxc/missing-throw": "warn",
+        "oxc/number-arg-out-of-range": "warn",
+        "oxc/only-used-in-recursion": "warn",
+        "oxc/uninvoked-array-callback": "warn",
+        "typescript/no-duplicate-enum-values": "warn",
+        "typescript/no-extra-non-null-assertion": "warn",
+        "typescript/no-misused-new": "warn",
+        "typescript/no-non-null-asserted-optional-chain": "warn",
+        "typescript/no-this-alias": "off",
+        "typescript/no-unnecessary-parameter-property-assignment": "warn",
+        "typescript/no-unsafe-declaration-merging": "warn",
+        "typescript/no-useless-empty-export": "warn",
+        "typescript/no-wrapper-object-types": "warn",
+        "typescript/prefer-as-const": "warn",
+        "typescript/triple-slash-reference": "warn",
+        "unicorn/no-await-in-promise-methods": "warn",
+        "unicorn/no-empty-file": "warn",
+        "unicorn/no-invalid-fetch-options": "warn",
+        "unicorn/no-invalid-remove-event-listener": "warn",
+        "unicorn/no-new-array": "warn",
+        "unicorn/no-single-promise-in-promise-methods": "warn",
+        "unicorn/no-thenable": "warn",
+        "unicorn/no-unnecessary-await": "warn",
+        "unicorn/no-useless-fallback-in-spread": "warn",
+        "unicorn/no-useless-length-check": "warn",
+        "unicorn/no-useless-spread": "warn",
+        "unicorn/prefer-set-size": "warn",
+        "unicorn/prefer-string-starts-ends-with": "warn"
+    },
+    "overrides": [
+        {
+            "files": ["packages/frontend/src/**/*.tsx"],
+            "rules": {
+                "{{projectName}}-react/max-component-complexity": [
+                    "error",
+                    {
+                        "maxHooks": 5,
+                        "maxHandlers": 3,
+                        "maxTotal": 7
+                    }
+                ],
+                "{{projectName}}-react-hooks/no-mixed-hooks-and-components": "warn"
+            }
+        },
+        {
+            "files": ["packages/frontend/src/**/*.{ts,tsx}"],
+            "rules": {
+                "{{projectName}}-react-hooks/hooks-in-hooks-folder": "warn"
+            }
+        },
+        {
+            "files": ["packages/frontend/src/components/ui/**/*.{ts,tsx}"],
+            "rules": {
+                "{{projectName}}-react/max-component-complexity": "off",
+                "{{projectName}}-react-hooks/no-mixed-hooks-and-components": "off",
+                "{{projectName}}-react-hooks/hooks-in-hooks-folder": "off"
+            }
+        },
+        {
+            "files": [
+                "**/*_test.{js,ts,tsx}",
+                "**/*.test.{js,ts,tsx}",
+                "**/test/**/*.{js,ts,tsx}",
+                "**/tests/*.{js,ts,tsx}",
+                "**/__tests__/**/*.{js,ts,tsx}",
+                "**/*.stories.{ts,tsx}"
+            ],
+            "rules": {
+                "eslint/max-lines-per-function": "off",
+                "{{projectName}}-react/max-component-complexity": "off",
+                "{{projectName}}-react-hooks/no-mixed-hooks-and-components": "off",
+                "{{projectName}}-react-hooks/hooks-in-hooks-folder": "off",
+                "{{projectName}}-testing/tests-in-tests-dir": "off"
+            }
+        }
+    ],
+    "settings": {
+        "jsx-a11y": {
+            "polymorphicPropName": null,
+            "components": {}
+        },
+        "react": {
+            "formComponents": [],
+            "linkComponents": []
+        },
+        "jsdoc": {
+            "ignorePrivate": false,
+            "ignoreInternal": false,
+            "ignoreReplacesDocs": true,
+            "overrideReplacesDocs": true,
+            "augmentsExtendsReplacesDocs": false,
+            "implementsReplacesDocs": false,
+            "exemptDestructuredRootsFromChecks": false,
+            "tagNamePreference": {}
+        }
+    },
+    "env": {
+        "builtin": true
+    },
+    "globals": {},
+    "ignorePatterns": [
+        "**/node_modules/**",
+        "**/dist/**",
+        ".claude/skills/**",
+        "**/.next/**",
+        "packages/frontend/src/routeTree.gen.ts"
+    ]
+}

package/templates/base/root/CLAUDE.md

@@ -0,0 +1,40 @@
+# {{projectTitle}}
+
+This repository was generated by `devstack`.
+
+## Working Agreement
+
+- Finish work only after `make check` passes.
+- Fix production issues revealed by tests instead of weakening the tests.
+- Prefer root-cause fixes over workarounds.
+- Keep changes reusable and product-agnostic until the domain is intentionally modeled.
+- Replace starter copy, routes and examples as soon as real product workflows exist.
+
+## Commands
+
+```bash
+bun install
+docker compose up -d
+bun run dev
+
+bun run lint
+bun run typecheck
+bun run test
+make check
+```
+
+## Workspace Layout
+
+- `packages/frontend`: React 19 + Vite + TanStack Router + TanStack Query + Tailwind v4
+- `packages/backend`: Hono + Drizzle + PostgreSQL + Zod OpenAPI helpers
+- `.github`, `.husky`, `Makefile`: shared quality and automation entrypoints
+
+## Development Notes
+
+- Use placeholders such as `{{projectName}}` and `{{projectTitle}}` only inside the generator templates, never in generated app code after scaffolding.
+- Keep the app shell generic until feature modules, auth and infra choices are finalized.
+- Treat CI, commit hooks and the Makefile as the default contract for quality gates.
+
+## Module Notes
+
+<!-- MODULE_SECTIONS -->

package/templates/base/root/Makefile

@@ -0,0 +1,57 @@
+ifneq (,$(wildcard .env))
+include .env
+export
+endif
+
+POSTGRES_CONTAINER ?= {{projectName}}-postgres
+POSTGRES_USER ?= postgres
+POSTGRES_DB ?= {{projectName}}
+POSTGRES_TEST_DB ?= {{projectName}}_test
+
+.PHONY: help check test lint lint-fix fmt fmt-check typecheck dev db-reset
+
+.DEFAULT_GOAL := help
+
+help: ## Display this help message
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} \
+	/^[a-zA-Z0-9_-]+:.*?##/ { printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2 } \
+	/^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+##@ Quality & Testing
+
+check: ## Run format check, lint, typecheck and tests
+	$(MAKE) fmt-check
+	$(MAKE) lint
+	$(MAKE) typecheck
+	$(MAKE) test
+
+test: ## Run tests
+	bun run test
+
+lint: ## Run linter
+	bun run lint
+
+lint-fix: ## Run linter and fix issues
+	bunx oxlint --fix
+
+fmt: ## Run formatter
+	bun run format
+
+fmt-check: ## Run formatter check
+	bun run format:check
+
+typecheck: ## Run type checker
+	bun run typecheck
+
+##@ Development
+
+dev: ## Start development servers
+	bun run dev
+
+##@ Database
+
+db-reset: ## Drop and recreate the main + test PostgreSQL databases
+	@docker exec "$(POSTGRES_CONTAINER)" psql -U "$(POSTGRES_USER)" -d postgres -v ON_ERROR_STOP=1 -c "DROP DATABASE IF EXISTS \"$(POSTGRES_DB)\" WITH (FORCE);"
+	@docker exec "$(POSTGRES_CONTAINER)" psql -U "$(POSTGRES_USER)" -d postgres -v ON_ERROR_STOP=1 -c "CREATE DATABASE \"$(POSTGRES_DB)\";"
+	@docker exec "$(POSTGRES_CONTAINER)" psql -U "$(POSTGRES_USER)" -d postgres -v ON_ERROR_STOP=1 -c "DROP DATABASE IF EXISTS \"$(POSTGRES_TEST_DB)\" WITH (FORCE);"
+	@docker exec "$(POSTGRES_CONTAINER)" psql -U "$(POSTGRES_USER)" -d postgres -v ON_ERROR_STOP=1 -c "CREATE DATABASE \"$(POSTGRES_TEST_DB)\";"

package/templates/base/root/commitlint.config.ts

@@ -0,0 +1,3 @@
+export default {
+  extends: ["@commitlint/config-conventional"],
+};

package/templates/base/root/docker/postgres/init-test-db.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env sh
+set -eu
+
+TEST_DATABASE="{{projectName}}_test"
+
+if psql -v ON_ERROR_STOP=1 --username "${POSTGRES_USER:-postgres}" --dbname postgres -tAc \
+  "SELECT 1 FROM pg_database WHERE datname = '${TEST_DATABASE}'" | grep -q 1; then
+  exit 0
+fi
+
+psql -v ON_ERROR_STOP=1 --username "${POSTGRES_USER:-postgres}" --dbname postgres -c \
+  "CREATE DATABASE \"${TEST_DATABASE}\";"