From f6a8566630d2ad5ef0bb5cfe39170f1e519cea36 Mon Sep 17 00:00:00 2001 From: martyy-code Date: Wed, 21 Oct 2026 12:30:36 +0200 Subject: [PATCH 1/3] chore(template): conform to template standard v1 Co-Authored-By: Claude Code --- .claude/settings.local.json | 29 -------------------- .github/dependabot.yml | 38 ++++++++++++++++++++++++++ .gitignore | 8 +++++- deesse-template.json | 53 +++++++++++++++++++++++++++++++++++++ package.json | 7 +++-- 5 files changed, 103 insertions(+), 32 deletions(-) delete mode 100644 .claude/settings.local.json create mode 100644 .github/dependabot.yml create mode 100644 deesse-template.json diff --git a/.claude/settings.local.json b/.claude/settings.local.json deleted file mode 100644 index 5ec1162..0000000 --- a/.claude/settings.local.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "permissions": { - "defaultMode": "bypassPermissions", - - "allow": ["Read(*)", "Write(*)", "Edit(*)", "Bash(*)", "Read(//tmp/**)"], - - "deny": [ - "Write(//tmp/**)", - "Edit(//tmp/**)", - "Bash(rm */tmp/*)", - - "Bash(kill *)", - "Bash(pkill *)", - "Bash(killall *)", - "Bash(xargs kill*)", - "Bash(taskkill*)", - - "Bash(git rebase *)", - "Bash(git reset --hard*)", - "Bash(git clean*)", - - "Bash(sudo *)", - "Bash(chmod *)", - "Bash(chown *)", - "Bash(rm -rf / *)", - "Bash(alias *)" - ] - } -} diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..f38341b --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,38 @@ +version: 2 +updates: + - package-ecosystem: "npm" + directory: "/" + schedule: + interval: "weekly" + day: "monday" + open-pull-requests-limit: 5 + groups: + npm-prod: + dependency-type: "production" + patterns: ["*"] + update-types: ["minor", "patch"] + npm-dev: + dependency-type: "development" + patterns: ["*"] + update-types: ["minor", "patch"] + versioning-strategy: increase + ignore: + # Major bumps are handled by hand. The Next.js major removes the + # global LayoutProps, PageProps and RouteContext types, and the + # application code still relies on them, so an automatic major + # pull request breaks the build. + - dependency-name: "*" + update-types: ["version-update:semver-major"] + + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "weekly" + day: "monday" + open-pull-requests-limit: 5 + groups: + actions: + patterns: ["*"] + commit-message: + prefix: "ci" + include: "scope" diff --git a/.gitignore b/.gitignore index 9e429e4..36b07ea 100644 --- a/.gitignore +++ b/.gitignore @@ -23,4 +23,10 @@ yarn-error.log* # others .env*.local .vercel -next-env.d.ts \ No newline at end of file +next-env.d.ts + +# Machine specific agent artefacts +.claude/settings.local.json +.claude/plans/ +.claude/worktrees/ +.claude/pr-body-*.md diff --git a/deesse-template.json b/deesse-template.json new file mode 100644 index 0000000..6ebdb1e --- /dev/null +++ b/deesse-template.json @@ -0,0 +1,53 @@ +{ + "$schema": "https://raw.githubusercontent.com/deessejs/deessejs/main/templates/schema/template-v2.json", + "name": "documentation-template", + "slug": "docs-starter", + "title": "Docs Starter", + "description": "A documentation site on Next.js 16 and Fumadocs with search, social images and LLM endpoints, so agents can read your docs.", + "version": "0.0.4", + "type": "template:starter", + "author": "DeesseJS ", + "license": "MIT", + "source": { + "repo": "deessejs/documentation-template", + "ref": "main" + }, + "requires": { + "runtime": "node", + "node": ">=22", + "packageManager": "pnpm@11.0.0" + }, + "product": { + "layer": "open-community", + "category": "docs", + "labels": ["fumadocs", "mdx", "nextjs", "llms"], + "image": "/ship-your-docs.png" + }, + "includes": ["**"], + "excludes": [ + ".changeset/*.md", + ".claude/settings.local.json", + ".claude/agent-memory/**", + ".claude/plans/**", + ".claude/worktrees/**", + ".claude/pr-body-*.md", + ".github/ISSUE_TEMPLATE/**", + ".github/CODEOWNERS", + ".github/FUNDING.yml", + ".github/PULL_REQUEST_TEMPLATE.md", + "CHANGELOG.md", + "**/node_modules/**", + "**/dist/**", + "**/.next/**", + "**/.turbo/**", + "**/coverage/**", + "**/.DS_Store", + "**/.env", + "**/.env.*" + ], + "fileTypes": { + "README.md": "doc", + "LICENSE": "doc", + "CONTRIBUTING.md": "doc" + } +} diff --git a/package.json b/package.json index 4947e49..b66fa0a 100644 --- a/package.json +++ b/package.json @@ -1,5 +1,5 @@ { - "name": ".", + "name": "documentation-template", "version": "0.0.4", "private": true, "scripts": { @@ -31,5 +31,8 @@ "typescript": "^6.0.3", "eslint": "^9.39.4", "eslint-config-next": "16.2.10" + }, + "engines": { + "node": ">=22" } -} \ No newline at end of file +} From 54f5653a8213e75363cad3a056435c24d277e0e1 Mon Sep 17 00:00:00 2001 From: martyy-code Date: Wed, 21 Oct 2026 12:49:16 +0200 Subject: [PATCH 2/3] ci(template): validate the template manifest against the published schema Rule 25 bis of the template standard. The workflow fetches the schema from the parent template and validates deesse-template.json with a pinned validator, so a manifest that drifts fails the pull request instead of the catalogue. Co-Authored-By: Claude Code --- .github/workflows/manifest.yml | 35 ++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 .github/workflows/manifest.yml diff --git a/.github/workflows/manifest.yml b/.github/workflows/manifest.yml new file mode 100644 index 0000000..a47d8db --- /dev/null +++ b/.github/workflows/manifest.yml @@ -0,0 +1,35 @@ +name: Manifest + +on: + pull_request: + branches: [main] + push: + branches: [main] + workflow_dispatch: + +concurrency: + group: manifest-${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +permissions: + contents: read + +jobs: + validate: + name: Validate the template manifest + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v5 + + - uses: actions/setup-node@v5 + with: + node-version: 24 + + - name: Fetch the published schema + run: | + curl --fail --silent --show-error --location \ + https://raw.githubusercontent.com/deessejs/deessejs/main/templates/schema/template-v2.json \ + --output "$RUNNER_TEMP/template-v2.json" + + - name: Validate deesse-template.json against the published schema + run: npx --yes ajv-cli@5.0.0 validate -s "$RUNNER_TEMP/template-v2.json" -d deesse-template.json From 36aa6470734fa3e1d304ecbb24675f2ff94dd8a3 Mon Sep 17 00:00:00 2001 From: martyy-code Date: Wed, 21 Oct 2026 13:04:48 +0200 Subject: [PATCH 3/3] ci(template): fetch the schema from the parent and validate the manifest Two fixes on the manifest validation workflow. The schema is fetched from the main branch of the parent template first and falls back on the branch that carries the standard, so the check works before the standard pull request lands. The automatic package manager cache of the setup node action is off. The workflow installs nothing, and the action was running the package manager to find its store path. Co-Authored-By: Claude Code --- .github/workflows/manifest.yml | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/.github/workflows/manifest.yml b/.github/workflows/manifest.yml index a47d8db..95bbc21 100644 --- a/.github/workflows/manifest.yml +++ b/.github/workflows/manifest.yml @@ -14,6 +14,9 @@ concurrency: permissions: contents: read +env: + COREPACK_ENABLE_STRICT: '0' + jobs: validate: name: Validate the template manifest @@ -24,12 +27,18 @@ jobs: - uses: actions/setup-node@v5 with: node-version: 24 + package-manager-cache: false + # The schema is the one of the parent template. It is on the main branch + # once the standard pull request lands, and on the standard branch before + # that, so the fetch tries the main branch first and falls back. - name: Fetch the published schema + env: + SCHEMA_ON_MAIN: https://raw.githubusercontent.com/deessejs/deessejs/main/templates/schema/template-v2.json + SCHEMA_ON_THE_STANDARD_BRANCH: https://raw.githubusercontent.com/deessejs/deessejs/chore/template-standard-v1/templates/schema/template-v2.json run: | - curl --fail --silent --show-error --location \ - https://raw.githubusercontent.com/deessejs/deessejs/main/templates/schema/template-v2.json \ - --output "$RUNNER_TEMP/template-v2.json" + curl --fail --silent --show-error --location "$SCHEMA_ON_MAIN" --output "$RUNNER_TEMP/template-v2.json" \ + || curl --fail --silent --show-error --location "$SCHEMA_ON_THE_STANDARD_BRANCH" --output "$RUNNER_TEMP/template-v2.json" - name: Validate deesse-template.json against the published schema run: npx --yes ajv-cli@5.0.0 validate -s "$RUNNER_TEMP/template-v2.json" -d deesse-template.json