POLAR@3

.editorconfig

@@ -1,4 +1,15 @@
-[*.{js,ts,vue,json}]
+[*.{js,ts,vue,json,html,css}]
+indent_style = tab
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yaml]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[vue2/*.{js,ts,vue,json}]
 indent_style = space
 indent_size = 2
 trim_trailing_whitespace = true

.env

@@ -0,0 +1 @@
+VITE_DEV_LANDING=""

.github/CODEOWNERS

@@ -1 +1 @@
-/packages @warm-coolguy @dopenguin @oeninghe-dataport
+* @warm-coolguy @dopenguin @oeninghe-dataport

.github/workflows/publish-packages.yml

@@ -1,45 +1,24 @@
-name: Publish packages with updated changelog to npmjs.org
+name: Publish @polar/polar to NPM registry
 
 on:
   push:
-    branches:
-      - main
+    tags:
+      - v*
 
 jobs:
   publish:
     runs-on: ubuntu-latest
-    outputs:
-      matrix: ${{ steps.matrix.outputs.TAGS }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
         with:
-          ssh-key: ${{ secrets.MAIN_BOT_KEY_PRIVATE }}
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20.16.0
+          node-version: 24.11.1
           registry-url: https://registry.npmjs.org/
       - run: npm ci
-      - run: |
-          RETURN_TAGS=$(node ./scripts/versionPackages)
-          echo "TAGS=$RETURN_TAGS" >> $GITHUB_ENV
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - uses: EndBug/add-and-commit@v9
-        with:
-          author_name: Dataport Geo Bot
-          author_email: polar@dataport.de
-      - run: |
-          for TAG in ${{ env.TAGS }}
-          do
-            git config user.name "Dataport Geo Bot"
-            git config user.email "polar@dataport.de"
-            git tag $TAG
-            git push origin $TAG
-            echo "Released and tagged $TAG"
-          done
-      - run: node ./scripts/publishPackages ${{ env.TAGS }}
+      - run: npm run build:ci
+      - run: npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - run: node ./scripts/createRelease ${{ env.TAGS }}
+      - run: node scripts/create-github-release.ts
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish-pages-next.yml

@@ -0,0 +1,26 @@
+name: Publish bleeding-edge documentation to gh-pages/next
+
+on:
+  push:
+    branches:
+      - next
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
+        with:
+          node-version: 24.11.1
+          registry-url: https://registry.npmjs.org/
+      - run: sudo apt install mkdocs mkdocs-material
+      - run: npm ci
+      - run: npm run docs:ci
+      - uses: JamesIves/github-pages-deploy-action@4a3abc783e1a24aeb44c16e869ad83caf6b4cc23
+        with:
+          folder: docs-html
+          target-folder: next

.github/workflows/run-tests.yaml

@@ -0,0 +1,37 @@
+name: Run automated tests
+on: push
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
+        with:
+          node-version: 24.11.1
+          registry-url: https://registry.npmjs.org/
+      - run: |
+          npm ci
+          npm run lint:ci
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
+        with:
+          node-version: 24.11.1
+          registry-url: https://registry.npmjs.org/
+      - run: |
+          npm ci
+          npm run test:ci
+  type-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
+      - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
+        with:
+          node-version: 24.11.1
+          registry-url: https://registry.npmjs.org/
+      - run: |
+          npm ci
+          npm run tsc:ci

.gitignore

@@ -1,10 +1,19 @@
+node_modules
+.eslintcache
+
+git-hooks.config.json
+
+/docs-html
+.dist.preview
+.vscode/settings.json
+
+# Old gitignore, maybe cleanup when migrated
 **/.eslintcache
 **/*.tgz
 **/.cache
 **/coverage
 **/dist
 **/dist-test
-**/docs
 **/node_modules
 **/tests_output
 **/test-results/
@@ -17,3 +26,5 @@
 /public
 logs/*.log
 logs
+
+.DS_Store

.husky/commit-msg

@@ -0,0 +1,20 @@
+#!/bin/sh
+set -e
+eval `node .husky/prepareConfig.js`
+if [ "$POLAR_SKIP_COMMIT_MSG" = "yes" ]
+then
+	exit 0
+fi
+
+if [ "$POLAR_LINT_COMMIT_MESSAGE" = "yes" ]
+then
+	if ! npx --no -- commitlint --edit $1
+	then
+		echo "Cannot commit: Invalid commit message." >&2
+		echo "Please edit your commit message appropriately." >&2
+		echo >&2
+		echo "If you want to commit anyway, set POLAR_LINT_COMMIT_MESSAGE=no" >&2
+		echo "If you want to skip all commit-msg checks, set POLAR_SKIP_COMMIT_MSG=yes" >&2
+		exit 1
+	fi
+fi

.husky/defaults.json

@@ -0,0 +1,10 @@
+{
+	"skipPreCommit": false,
+	"allowDirtyCommit": true,
+	"lintOnCommit": false,
+	"typecheckOnCommit": false,
+	"testOnCommit": false,
+
+	"skipCommitMsg": false,
+	"lintCommitMessage": true
+}

.husky/install.js

@@ -0,0 +1,3 @@
+/* eslint-disable no-console */
+const { default: husky } = await import('husky')
+console.info(husky())

.husky/pre-commit

@@ -0,0 +1,62 @@
+#!/bin/sh
+set -e
+eval `node .husky/prepareConfig.js`
+if [ "$POLAR_SKIP_PRE_COMMIT" = "yes" ]
+then
+	exit 0
+fi
+
+if [ "$POLAR_ALLOW_DIRTY_COMMIT" = "no" ]
+then
+	git rev-parse --verify HEAD >/dev/null || exit 1
+	git update-index -q --ignore-submodules --refresh
+
+	if ! git diff-files --quiet --ignore-submodules
+	then
+		echo "Cannot commit: You have unstaged changes." >&2
+		echo "Please stage, stash or drop these changes." >&2
+		echo >&2
+		echo "If you want to commit anyway, set POLAR_ALLOW_DIRTY_COMMIT=yes" >&2
+		echo "If you want to skip all pre-commit checks, set POLAR_SKIP_PRE_COMMIT=yes" >&2
+		exit 1
+	fi
+fi
+
+if [ "$POLAR_LINT_ON_COMMIT" = "yes" ]
+then
+	if ! npm run lint
+	then
+		echo "Cannot commit: Linting failed." >&2
+		echo "Please fix the above error(s)." >&2
+		echo >&2
+		echo "If you want to commit anyway, set POLAR_LINT_ON_COMMIT=no" >&2
+		echo "If you want to skip all pre-commit checks, set POLAR_SKIP_PRE_COMMIT=yes" >&2
+		exit 1
+	fi
+fi
+
+if [ "$POLAR_TYPECHECK_ON_COMMIT" = "yes" ]
+then
+	if ! npm run tsc
+	then
+		echo "Cannot commit: Type checking failed." >&2
+		echo "Please fix the above error(s)." >&2
+		echo >&2
+		echo "If you want to commit anyway, set POLAR_TYPECHECK_ON_COMMIT=no" >&2
+		echo "If you want to skip all pre-commit checks, set POLAR_SKIP_PRE_COMMIT=yes" >&2
+		exit 1
+	fi
+fi
+
+if [ "$POLAR_TEST_ON_COMMIT" = "yes" ]
+then
+	if ! npm run test:ci
+	then
+		echo "Cannot commit: Unit testing failed." >&2
+		echo "Please fix the above error(s)." >&2
+		echo >&2
+		echo "If you want to commit anyway, set POLAR_TEST_ON_COMMIT=no" >&2
+		echo "If you want to skip all pre-commit checks, set POLAR_SKIP_PRE_COMMIT=yes" >&2
+		exit 1
+	fi
+fi