feature: fumadocs

.github/workflows/deploy-docs.yml

@@ -0,0 +1,116 @@
+name: Deploy Docs
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+    branches:
+      - main
+    paths:
+      - ".github/workflows/deploy-docs.yml"
+      - "next/**"
+  push:
+    branches:
+      - main
+    paths:
+      - ".github/workflows/deploy-docs.yml"
+      - "next/**"
+  workflow_dispatch:
+
+concurrency:
+  group: deploy-docs-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions: { }
+
+jobs:
+  build:
+    name: Build docs
+    if:  github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Restore npm cache
+        id: npm-cache
+        uses: actions/cache/restore@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
+        with:
+          path: &build-docs-npm-cache-paths |
+            ~/.npm
+            ${{ github.workspace }}/next/.next/cache
+          key: ${{ runner.os }}-${{ runner.arch }}-npm-docs-${{ hashFiles('next/package-lock.json') }}-${{ hashFiles('next/**.[jt]s', 'next/**.[jt]sx') }}
+          restore-keys: |
+            ${{ runner.os }}-${{ runner.arch }}-npm-docs-${{ hashFiles('next/package-lock.json') }}-
+
+      - name: Install docs dependencies
+        working-directory: next
+        run: npm ci
+
+      - name: Generated source
+        working-directory: next
+        run: npm run generated-source
+
+#      - name: Check docs formatting
+#        working-directory: next
+#        run: npm run fmt:check
+#
+#      - name: Lint Check docs
+#        working-directory: next
+#        run: npm run lint
+
+      - name: Build docs
+        working-directory: next
+        env:
+          NEXT_TELEMETRY_DISABLED: '1'
+        run: npm run build
+
+      - name: Generate redirect files
+        working-directory: next
+        run: npm run generate-redirects
+
+      - name: Save npm cache
+        if: github.ref == 'refs/heads/main' && steps.npm-cache.outputs.cache-hit != 'true'
+        uses: actions/cache/save@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
+        with:
+          path: *build-docs-npm-cache-paths
+          key: ${{ steps.npm-cache.outputs.cache-primary-key }}
+
+      - name: Upload GitHub Pages artifact
+        if: github.ref == 'refs/heads/main' && github.repository == 'the-ton-tech/ton-docs-private'
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
+        with:
+          path: next/out
+
+  deploy:
+    name: Deploy docs
+    if: github.ref == 'refs/heads/main' && github.repository == 'the-ton-tech/ton-docs-private'
+    needs: [ build ]
+    runs-on: ubuntu-latest
+
+    permissions:
+      pages: write    # to deploy to Pages
+      id-token: write # to verify the deployment originates from an appropriate source
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0

.github/workflows/next-build.yml

@@ -0,0 +1,80 @@
+name: Next.js build & lint
+
+on:
+  pull_request:
+    branches: ["**"]
+    paths:
+      - "next/**"
+      - ".github/workflows/next-build.yml"
+  push:
+    branches: ["main", "master"]
+    paths:
+      - "next/**"
+      - ".github/workflows/next-build.yml"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build Next.js docs
+    runs-on: ubuntu-latest
+    env:
+      NEXT_TELEMETRY_DISABLED: "1"
+      HUSKY: "0"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Setup Node.js 22
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: next/package-lock.json
+
+      - name: Install dependencies
+        working-directory: next
+        run: npm ci
+
+      - name: Generate Fumadocs source
+        working-directory: next
+        run: npm run generated-source
+
+      - name: Prettier check
+        working-directory: next
+        run: npm run fmt:check
+        continue-on-error: true
+
+      - name: ESLint
+        working-directory: next
+        run: npm run lint
+        continue-on-error: true
+
+      - name: Validate navigation
+        working-directory: next
+        run: npm run lint:navigation
+
+      - name: Validate internal links
+        working-directory: next
+        run: npm run lint:links:internal
+
+      - name: Validate links
+        working-directory: next
+        run: npm run lint:links:validate
+
+      - name: Validate SEO continuity (redirects, chains, sitemap, canonical)
+        working-directory: next
+        run: npm run lint:seo
+
+      - name: Next build
+        working-directory: next
+        run: npm run build

.gitignore

@@ -16,6 +16,9 @@
 .emacs.d/
 .zed/
 
+# Claude Code session state (worktrees, caches)
+.claude/
+
 # Node.js
 node_modules/
 
@@ -24,3 +27,7 @@ __pycache__
 
 # Generated folders
 /stats/
+
+dist
+export.zip
+next/pnpm-lock.yaml

.mintignore

@@ -0,0 +1 @@
+next/

contract-dev/introduction.mdx

@@ -0,0 +1,14 @@
+---
+title: "Introduction to smart contract development"
+sidebarTitle: "Introduction"
+---
+
+To start developing smart contracts on TON, use our Rust toolkit, [Acton](https://ton-blockchain.github.io/acton/docs/welcome).
+
+The recommended smart contract language is [Tolk](https://docs.ton.org/tolk/overview).
+
+In the sections below, you can also learn about the following:
+
+- IDEs and editor plugins: [VS Code](/contract-dev/ide/vscode) and [JetBrains IDEs](/contract-dev/ide/jetbrains)
+- Techniques: [signing messages](/contract-dev/techniques/signing), [contract sharding](/contract-dev/techniques/contract-sharding), and more
+- [Blueprint](/contract-dev/blueprint/overview) (for legacy developers)