From 0de8f010a7368b12ff28cf35e6395bab860add9f Mon Sep 17 00:00:00 2001 From: Yasiru Geevinda Date: Tue, 11 Aug 2026 19:17:49 +0000 Subject: [PATCH 1/3] fix: issues on postkit skill, repo migration changes, minor docs (cherry picked from commit 511d4d81a86f0c11fab66c0837bca42e6bce96fb) --- .claude/skills/architecture/SKILL.md | 2 + .claude/skills/bugfix/SKILL.md | 4 +- .claude/skills/create-feature/SKILL.md | 4 +- .claude/skills/create-pr/SKILL.md | 2 + .claude/skills/update-docs/SKILL.md | 2 + .claude/skills/write-test-e2e/SKILL.md | 2 + .claude/skills/write-test-unit/SKILL.md | 2 + CLAUDE.md | 51 +++++++++++++++---- README.md | 6 +-- cli/README.md | 6 +-- cli/package.json | 6 +-- docs/docs/agent-skills/overview.md | 37 ++++++++++---- docs/docs/getting-started/installation.md | 4 +- docs/docs/modules/db/troubleshooting.md | 2 +- docs/docusaurus.config.ts | 12 ++--- docs/src/pages/index.tsx | 2 +- .../skills => skills}/postkit-auth/SKILL.md | 0 .../postkit-migrate/SKILL.md | 0 .../skills => skills}/postkit-schema/SKILL.md | 0 .../skills => skills}/postkit-setup/SKILL.md | 0 20 files changed, 101 insertions(+), 43 deletions(-) rename {agent/skills => skills}/postkit-auth/SKILL.md (100%) rename {agent/skills => skills}/postkit-migrate/SKILL.md (100%) rename {agent/skills => skills}/postkit-schema/SKILL.md (100%) rename {agent/skills => skills}/postkit-setup/SKILL.md (100%) diff --git a/.claude/skills/architecture/SKILL.md b/.claude/skills/architecture/SKILL.md index d0c60f2..2f2087c 100644 --- a/.claude/skills/architecture/SKILL.md +++ b/.claude/skills/architecture/SKILL.md @@ -1,6 +1,8 @@ --- name: architecture description: Review and propose system architecture decisions, generate ADRs. +metadata: + internal: true --- # Architecture Skill diff --git a/.claude/skills/bugfix/SKILL.md b/.claude/skills/bugfix/SKILL.md index 4a787b7..7580346 100644 --- a/.claude/skills/bugfix/SKILL.md +++ b/.claude/skills/bugfix/SKILL.md @@ -1,6 +1,8 @@ --- name: bugfix -description: Diagnose and fix bugs with a 4-stage workflow: gather info, diagnose, fix, test, validate & review. +description: "Diagnose and fix bugs with a 4-stage workflow: gather info, diagnose, fix, test, validate & review." +metadata: + internal: true --- # Bugfix Skill diff --git a/.claude/skills/create-feature/SKILL.md b/.claude/skills/create-feature/SKILL.md index 3e6cea5..3fb793d 100644 --- a/.claude/skills/create-feature/SKILL.md +++ b/.claude/skills/create-feature/SKILL.md @@ -1,6 +1,8 @@ --- name: create-feature -description: Implement new features end-to-end: gather info, plan, implement, test, validate, review. +description: "Implement new features end-to-end: gather info, plan, implement, test, validate, review." +metadata: + internal: true --- # Create Feature Skill diff --git a/.claude/skills/create-pr/SKILL.md b/.claude/skills/create-pr/SKILL.md index 70a34ac..50f4649 100644 --- a/.claude/skills/create-pr/SKILL.md +++ b/.claude/skills/create-pr/SKILL.md @@ -3,6 +3,8 @@ name: create-pr description: Generate a PR description for the current branch and save it to temp/pr-description.md. Analyzes commits against the base branch and fills in the project PR template exactly. argument-hint: "[base-branch]" allowed-tools: Bash, Read, Write +metadata: + internal: true --- # Create PR Skill diff --git a/.claude/skills/update-docs/SKILL.md b/.claude/skills/update-docs/SKILL.md index 052bca4..17a5fb6 100644 --- a/.claude/skills/update-docs/SKILL.md +++ b/.claude/skills/update-docs/SKILL.md @@ -1,6 +1,8 @@ --- name: update-docs description: Update project documentation when code changes occur. +metadata: + internal: true --- # Update Docs Skill diff --git a/.claude/skills/write-test-e2e/SKILL.md b/.claude/skills/write-test-e2e/SKILL.md index 8bb1be0..832033d 100644 --- a/.claude/skills/write-test-e2e/SKILL.md +++ b/.claude/skills/write-test-e2e/SKILL.md @@ -1,6 +1,8 @@ --- name: write-test-e2e description: Write end-to-end tests for PostKit CLI using testcontainers and black-box testing. +metadata: + internal: true --- # Write E2E Tests Skill diff --git a/.claude/skills/write-test-unit/SKILL.md b/.claude/skills/write-test-unit/SKILL.md index 4f65ebf..6290d64 100644 --- a/.claude/skills/write-test-unit/SKILL.md +++ b/.claude/skills/write-test-unit/SKILL.md @@ -1,6 +1,8 @@ --- name: write-test-unit description: Write unit tests for PostKit CLI using Vitest with proper mocking patterns. +metadata: + internal: true --- # Write Unit Tests Skill diff --git a/CLAUDE.md b/CLAUDE.md index ec7b40f..aa22876 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -384,10 +384,10 @@ PostKit ships with Claude Code agent skills that teach AI assistants how to work ### Skill Anatomy -Each skill lives in its own directory under `agent/skills/`: +Each skill lives in its own directory under `skills/`: ``` -agent/skills/ +skills/ ├── postkit-migrate/ │ └── SKILL.md # Frontmatter (name, description, allowed-tools) + markdown instructions ├── postkit-setup/ @@ -423,19 +423,24 @@ Use the [skills CLI](https://github.com/vercel-labs/skills) to install PostKit s ```bash # Install all PostKit skills (interactive) -npx skills add appritechnologies/Postkit +npx skills add postkitstack/Postkit # List available skills first -npx skills add appritechnologies/Postkit --list +npx skills add postkitstack/Postkit --list # Install specific skills only -npx skills add appritechnologies/Postkit --skill postkit-migrate --skill postkit-schema +npx skills add postkitstack/Postkit --skill postkit-migrate --skill postkit-schema # Install for a specific agent (e.g., Claude Code) -npx skills add appritechnologies/Postkit -a claude-code - -# Non-interactive (CI/CD friendly) -npx skills add appritechnologies/Postkit --all -y +npx skills add postkitstack/Postkit -a claude-code + +# Non-interactive (CI/CD friendly) — name each skill explicitly. +# Avoid `--all`: it expands to every skill *and* every agent, and it +# bypasses the internal-skill filter, so it also pulls PostKit's own +# repo-maintenance skills into your project. +npx skills add postkitstack/Postkit -y --agent claude-code \ + --skill postkit-migrate --skill postkit-setup \ + --skill postkit-schema --skill postkit-auth ``` The CLI auto-detects which coding agents you have installed and places skills in the correct directory for each agent. By default, skills are symlinked (single source of truth, easy to update). Use `--copy` for independent copies. @@ -454,7 +459,7 @@ npx skills update postkit-auth # Update a specific skill ### Adding a New Skill -Create `agent/skills//SKILL.md`: +For a **public** skill (one PostKit users install), create `skills//SKILL.md`. For internal contributor tooling, use `.claude/skills/` instead and read [Public vs Internal Skills](#public-vs-internal-skills) first. ```yaml --- @@ -467,7 +472,7 @@ allowed-tools: Bash(postkit *) Skills can optionally include bundled resources for more complex workflows: ``` -agent/skills// +skills// ├── SKILL.md # Required — skill instructions ├── scripts/ # Optional — executable scripts for repetitive tasks ├── references/ # Optional — reference docs loaded into context as needed @@ -476,6 +481,28 @@ agent/skills// When a skill grows beyond ~500 lines, split domain-specific content into `references/` files and point to them from SKILL.md. +### Public vs Internal Skills + +Two kinds of skills live in this repo, and the split is load-bearing for packaging: + +| Location | Kind | Shipped by `npx skills add` | +|----------|------|-----------------------------| +| `skills/` | Public — for people *using* PostKit | Yes | +| `.claude/skills/` | Internal — for people *developing* PostKit | No | + +`skills/` is a directory the skills CLI searches by default; `agent/skills/` is **not**, which is why public skills live at `skills/`. + +`.claude/skills/` is also a directory the CLI searches, so every internal skill must carry: + +```yaml +metadata: + internal: true +``` + +Without it, contributor tooling (`/bugfix`, `/create-pr`, …) gets installed into end users' projects. The flag hides the skill from discovery, `--list`, and interactive install; Claude Code ignores the field and loads the skill locally as normal. Contributors can still fetch internal skills with `INSTALL_INTERNAL_SKILLS=1` or an explicit `--skill `. + +Descriptions containing `: ` (colon-space) **must be quoted** — unquoted, YAML parses them as a nested mapping and the skills CLI skips the file with a parse error. + ## Important Notes - All paths in `common/config.ts` are resolved relative to either `cliRoot` (the CLI installation) or `projectRoot` (where the user runs commands). @@ -500,6 +527,8 @@ Skills are invoked via `/` in Claude Code. Agents are sub-processes ### Skills Registry +These are **internal** skills — they live in `.claude/skills/` and must each carry `metadata: internal: true` so they are not shipped to end users. See [Public vs Internal Skills](#public-vs-internal-skills). + | Skill | Invocation | Purpose | Sub-Agents | |-------|-----------|---------|------------| | create-pr | `/create-pr` | Generate PR description to `temp/pr-description.md` | — | diff --git a/README.md b/README.md index 0f7d4e6..22c14a9 100644 --- a/README.md +++ b/README.md @@ -81,15 +81,15 @@ No restart needed — Claude Code picks up changes automatically. Full documentation is available at [docs.postkitstack.com](https://docs.postkitstack.com/). -For more help, see [Troubleshooting](https://docs.postkitstack.com/docs/modules/db/troubleshooting) or open an issue on [GitHub](https://github.com/appritechnologies/postkit/issues). +For more help, see [Troubleshooting](https://docs.postkitstack.com/docs/modules/db/troubleshooting) or open an issue on [GitHub](https://github.com/postkitstack/Postkit/issues). ## Links - **CLI Tool**: [cli/README.md](cli/README.md) - **npm Package**: https://www.npmjs.com/package/@appritech/postkit - **Documentation**: https://docs.postkitstack.com/ -- **GitHub**: https://github.com/appritechnologies/postkit -- **Issues**: https://github.com/appritechnologies/postkit/issues +- **GitHub**: https://github.com/postkitstack/Postkit +- **Issues**: https://github.com/postkitstack/Postkit/issues ## License diff --git a/cli/README.md b/cli/README.md index 1f5cc8a..aa43784 100644 --- a/cli/README.md +++ b/cli/README.md @@ -186,14 +186,14 @@ postkit db commit postkit db deploy --remote staging ``` -For more help, see [Troubleshooting](https://docs.postkitstack.com/docs/modules/db/troubleshooting) or open an issue on [GitHub](https://github.com/appritechnologies/postkit/issues). +For more help, see [Troubleshooting](https://docs.postkitstack.com/docs/modules/db/troubleshooting) or open an issue on [GitHub](https://github.com/postkitstack/Postkit/issues). ## 🔗 Links - **npm Package**: https://www.npmjs.com/package/@appritech/postkit - **Documentation**: https://docs.postkitstack.com/ -- **GitHub**: https://github.com/appritechnologies/postkit -- **Issues**: https://github.com/appritechnologies/postkit/issues +- **GitHub**: https://github.com/postkitstack/Postkit +- **Issues**: https://github.com/postkitstack/Postkit/issues ## 📜 License diff --git a/cli/package.json b/cli/package.json index 11492c6..dfaaa3c 100644 --- a/cli/package.json +++ b/cli/package.json @@ -46,11 +46,11 @@ "license": "Apache-2.0", "repository": { "type": "git", - "url": "https://github.com/appritechnologies/postkit.git" + "url": "https://github.com/postkitstack/Postkit.git" }, - "homepage": "https://github.com/appritechnologies/postkit#readme", + "homepage": "https://github.com/postkitstack/Postkit#readme", "bugs": { - "url": "https://github.com/appritechnologies/postkit/issues" + "url": "https://github.com/postkitstack/Postkit/issues" }, "dependencies": { "chalk": "^5.3.0", diff --git a/docs/docs/agent-skills/overview.md b/docs/docs/agent-skills/overview.md index 500e6b6..4d945ad 100644 --- a/docs/docs/agent-skills/overview.md +++ b/docs/docs/agent-skills/overview.md @@ -21,30 +21,45 @@ Use the [skills CLI](https://github.com/vercel-labs/skills) to install PostKit s ```bash # Install all PostKit skills (interactive) -npx skills add appritechnologies/Postkit +npx skills add postkitstack/Postkit # List available skills first -npx skills add appritechnologies/Postkit --list +npx skills add postkitstack/Postkit --list # Install specific skills only -npx skills add appritechnologies/Postkit --skill postkit-migrate --skill postkit-schema +npx skills add postkitstack/Postkit --skill postkit-migrate --skill postkit-schema # Install for a specific agent (e.g., Claude Code) -npx skills add appritechnologies/Postkit -a claude-code - -# Non-interactive (CI/CD friendly) -npx skills add appritechnologies/Postkit --all -y +npx skills add postkitstack/Postkit -a claude-code + +# Non-interactive (CI/CD friendly) — name each skill explicitly. +# Avoid `--all`: it expands to every skill *and* every agent, and it +# bypasses the internal-skill filter, so it also pulls PostKit's own +# repo-maintenance skills into your project. +npx skills add postkitstack/Postkit -y --agent claude-code \ + --skill postkit-migrate --skill postkit-setup \ + --skill postkit-schema --skill postkit-auth ``` ### Scope -| Scope | Flag | Location | Use Case | -|-------|------|----------|----------| -| **Project** (default) | | `.//skills/` | Committed with your project, shared with team | -| **Global** | `-g` | `~//skills/` | Available across all your projects | +| Scope | Flag | Location (Claude Code) | Use Case | +|-------|------|------------------------|----------| +| **Project** (default) | | `./.claude/skills/` | Committed with your project, shared with team | +| **Global** | `-g` | `~/.claude/skills/` | Available across all your projects | + +The exact directory depends on the agent. Claude Code uses `.claude/skills/`; Cursor, Codex, Cline, Gemini CLI, and GitHub Copilot share the standard `.agents/skills/`; Windsurf and Roo Code use `.windsurf/skills/` and `.roo/skills/`. The CLI picks the right one for each agent you install to. By default, skills are **symlinked** — a single source of truth that's easy to update. Use `--copy` for independent copies when symlinks aren't supported. +### Verify the Install + +```bash +npx skills list +``` + +You should see the four `postkit-*` skills. In Claude Code, `/postkit-migrate` and friends become available in new sessions. + ### Update Skills ```bash diff --git a/docs/docs/getting-started/installation.md b/docs/docs/getting-started/installation.md index bdb9dfb..0777dee 100644 --- a/docs/docs/getting-started/installation.md +++ b/docs/docs/getting-started/installation.md @@ -48,8 +48,8 @@ npm install -g @appritech/postkit ```bash # Clone the repository -git clone https://github.com/appritechnologies/postkit.git -cd postkit/cli +git clone https://github.com/postkitstack/Postkit.git +cd Postkit/cli # Install dependencies npm install diff --git a/docs/docs/modules/db/troubleshooting.md b/docs/docs/modules/db/troubleshooting.md index 89c2112..ee8e2c1 100644 --- a/docs/docs/modules/db/troubleshooting.md +++ b/docs/docs/modules/db/troubleshooting.md @@ -102,4 +102,4 @@ The container ID is stored in `.postkit/db/session.json` under `containerID` if ## Getting Help -If you're still stuck, please open an issue on [GitHub](https://github.com/appritechnologies/postkit/issues). +If you're still stuck, please open an issue on [GitHub](https://github.com/postkitstack/Postkit/issues). diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts index 1ebab87..8f2e4a6 100644 --- a/docs/docusaurus.config.ts +++ b/docs/docusaurus.config.ts @@ -22,8 +22,8 @@ const config: Config = { // GitHub pages deployment config. // If you aren't using GitHub pages, you don't need these. - organizationName: 'appritechnologies', // Usually your GitHub org/user name. - projectName: 'postkit', // Usually your repo name. + organizationName: 'postkitstack', // Usually your GitHub org/user name. + projectName: 'Postkit', // Usually your repo name. onBrokenLinks: 'throw', @@ -57,7 +57,7 @@ const config: Config = { // Please change this to your repo. // Remove this to remove the "edit this page" links. editUrl: - 'https://github.com/appritechnologies/postkit/edit/main/docs/', + 'https://github.com/postkitstack/Postkit/edit/main/docs/', }, blog: { showReadingTime: true, @@ -68,7 +68,7 @@ const config: Config = { // Please change this to your repo. // Remove this to remove the "edit this page" links. editUrl: - 'https://github.com/appritechnologies/postkit/edit/main/docs/', + 'https://github.com/postkitstack/Postkit/edit/main/docs/', // Useful options to enforce blogging best practices onInlineTags: 'warn', onInlineAuthors: 'warn', @@ -106,7 +106,7 @@ const config: Config = { position: 'left', }, { - href: 'https://github.com/appritechnologies/postkit', + href: 'https://github.com/postkitstack/Postkit', label: 'GitHub', position: 'right', }, @@ -137,7 +137,7 @@ const config: Config = { items: [ { label: 'GitHub', - href: 'https://github.com/appritechnologies/postkit', + href: 'https://github.com/postkitstack/Postkit', }, { label: 'Documentation', diff --git a/docs/src/pages/index.tsx b/docs/src/pages/index.tsx index 9d54ae0..d0a011c 100644 --- a/docs/src/pages/index.tsx +++ b/docs/src/pages/index.tsx @@ -35,7 +35,7 @@ function HomepageHero() { GitHub diff --git a/agent/skills/postkit-auth/SKILL.md b/skills/postkit-auth/SKILL.md similarity index 100% rename from agent/skills/postkit-auth/SKILL.md rename to skills/postkit-auth/SKILL.md diff --git a/agent/skills/postkit-migrate/SKILL.md b/skills/postkit-migrate/SKILL.md similarity index 100% rename from agent/skills/postkit-migrate/SKILL.md rename to skills/postkit-migrate/SKILL.md diff --git a/agent/skills/postkit-schema/SKILL.md b/skills/postkit-schema/SKILL.md similarity index 100% rename from agent/skills/postkit-schema/SKILL.md rename to skills/postkit-schema/SKILL.md diff --git a/agent/skills/postkit-setup/SKILL.md b/skills/postkit-setup/SKILL.md similarity index 100% rename from agent/skills/postkit-setup/SKILL.md rename to skills/postkit-setup/SKILL.md From da725d7415f30084026279b11dd3a06848d13e16 Mon Sep 17 00:00:00 2001 From: Yasiru Geevinda Date: Fri, 28 Aug 2026 20:11:07 +0000 Subject: [PATCH 2/3] chore: re-scope npm package to @postkitstack/postkit Rename the published package from @appritech/postkit to @postkitstack/postkit to match the new postkitstack npm org. - cli/package.json + package-lock.json: package name - README.md, cli/README.md: install commands, badges, npm links - docs (installation, intro, blog posts): install commands - docs/blog/authors.yml: GitHub org URL (missed by #50) Bin name (postkit) and version (1.3.2) unchanged. --- README.md | 6 +++--- cli/README.md | 10 +++++----- cli/package-lock.json | 8 ++++---- cli/package.json | 2 +- docs/blog/2026-05-04-migrating-from-prisma.md | 2 +- docs/blog/2026-05-10-why-session-based-migrations.md | 2 +- .../2026-05-12-migrating-from-supabase-to-postkit.md | 4 ++-- docs/blog/authors.yml | 4 ++-- docs/docs/getting-started/installation.md | 2 +- docs/docs/intro.mdx | 2 +- 10 files changed, 21 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 22c14a9..5c646f2 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ PostKit brings together the following components: ## PostKit CLI -The PostKit CLI (`@appritech/postkit`) is the developer toolkit for working with the PostKit stack. It provides safe database migrations, auth management, and project scaffolding. +The PostKit CLI (`@postkitstack/postkit`) is the developer toolkit for working with the PostKit stack. It provides safe database migrations, auth management, and project scaffolding. **Documentation:** [https://docs.postkitstack.com/](https://docs.postkitstack.com/) @@ -30,7 +30,7 @@ The PostKit CLI (`@appritech/postkit`) is the developer toolkit for working with ```bash # Install the CLI -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit # Initialize a new project postkit init @@ -86,7 +86,7 @@ For more help, see [Troubleshooting](https://docs.postkitstack.com/docs/modules/ ## Links - **CLI Tool**: [cli/README.md](cli/README.md) -- **npm Package**: https://www.npmjs.com/package/@appritech/postkit +- **npm Package**: https://www.npmjs.com/package/@postkitstack/postkit - **Documentation**: https://docs.postkitstack.com/ - **GitHub**: https://github.com/postkitstack/Postkit - **Issues**: https://github.com/postkitstack/Postkit/issues diff --git a/cli/README.md b/cli/README.md index aa43784..4a04afd 100644 --- a/cli/README.md +++ b/cli/README.md @@ -1,11 +1,11 @@ -# @appritech/postkit +# @postkitstack/postkit > Developer toolkit for database migrations and backend automation **Note:** This tool is still under development and not recommended for production use. APIs may change between versions. -[![npm version](https://badge.fury.io/js/@appritech/postkit.svg)](https://www.npmjs.com/package/@appritech/postkit) -[![License](https://img.shields.io/npm/l/@appritech/postkit.svg)](LICENSE) +[![npm version](https://badge.fury.io/js/@postkitstack/postkit.svg)](https://www.npmjs.com/package/@postkitstack/postkit) +[![License](https://img.shields.io/npm/l/@postkitstack/postkit.svg)](LICENSE) PostKit CLI is a modular toolkit for backend development with the Appri stack. It provides safe database migrations, auth management, and more. @@ -16,7 +16,7 @@ PostKit CLI is a modular toolkit for backend development with the Appri stack. I ### Installation ```bash -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit ``` ### Requirements @@ -190,7 +190,7 @@ For more help, see [Troubleshooting](https://docs.postkitstack.com/docs/modules/ ## 🔗 Links -- **npm Package**: https://www.npmjs.com/package/@appritech/postkit +- **npm Package**: https://www.npmjs.com/package/@postkitstack/postkit - **Documentation**: https://docs.postkitstack.com/ - **GitHub**: https://github.com/postkitstack/Postkit - **Issues**: https://github.com/postkitstack/Postkit/issues diff --git a/cli/package-lock.json b/cli/package-lock.json index 5970d0b..e113d65 100644 --- a/cli/package-lock.json +++ b/cli/package-lock.json @@ -1,12 +1,12 @@ { - "name": "@appritech/postkit", - "version": "1.3.1", + "name": "@postkitstack/postkit", + "version": "1.3.2", "lockfileVersion": 3, "requires": true, "packages": { "": { - "name": "@appritech/postkit", - "version": "1.3.1", + "name": "@postkitstack/postkit", + "version": "1.3.2", "license": "Apache-2.0", "dependencies": { "chalk": "^5.3.0", diff --git a/cli/package.json b/cli/package.json index dfaaa3c..3079cb5 100644 --- a/cli/package.json +++ b/cli/package.json @@ -1,5 +1,5 @@ { - "name": "@appritech/postkit", + "name": "@postkitstack/postkit", "version": "1.3.2", "description": "PostKit - Developer toolkit for database management and more", "type": "module", diff --git a/docs/blog/2026-05-04-migrating-from-prisma.md b/docs/blog/2026-05-04-migrating-from-prisma.md index 9465633..b84ec8b 100644 --- a/docs/blog/2026-05-04-migrating-from-prisma.md +++ b/docs/blog/2026-05-04-migrating-from-prisma.md @@ -35,7 +35,7 @@ The transition has two phases: getting your current schema into PostKit, then sw PostKit's `db import` command reads your current PostgreSQL database (not your `schema.prisma`) and generates schema files: ```bash -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit postkit init # Add your database as a remote diff --git a/docs/blog/2026-05-10-why-session-based-migrations.md b/docs/blog/2026-05-10-why-session-based-migrations.md index 12200ea..93261c9 100644 --- a/docs/blog/2026-05-10-why-session-based-migrations.md +++ b/docs/blog/2026-05-10-why-session-based-migrations.md @@ -113,7 +113,7 @@ For databases where a full clone is impractical (100GB+), you can use a represen ## Getting Started ```bash -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit postkit init postkit db remote add prod "postgres://..." --default postkit db start # clone happens here diff --git a/docs/blog/2026-05-12-migrating-from-supabase-to-postkit.md b/docs/blog/2026-05-12-migrating-from-supabase-to-postkit.md index c3b7659..e3d1154 100644 --- a/docs/blog/2026-05-12-migrating-from-supabase-to-postkit.md +++ b/docs/blog/2026-05-12-migrating-from-supabase-to-postkit.md @@ -31,7 +31,7 @@ PostKit does not replace Supabase's auth, storage, or realtime features. If you ## Step 1: Install PostKit ```bash -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit ``` Verify: @@ -205,7 +205,7 @@ If you have existing Supabase migration files (`.sql` files in `supabase/migrati | Step | Command | |------|---------| -| Install PostKit | `npm install -g @appritech/postkit` | +| Install PostKit | `npm install -g @postkitstack/postkit` | | Init project | `postkit init` | | Add Supabase remote | `postkit db remote add supabase "postgres://..."` | | Import existing schema | `postkit db import --url "postgres://..."` | diff --git a/docs/blog/authors.yml b/docs/blog/authors.yml index f7ec0e2..0a44554 100644 --- a/docs/blog/authors.yml +++ b/docs/blog/authors.yml @@ -1,5 +1,5 @@ postkit_team: name: PostKit Team title: Appri Technologies - url: https://github.com/appritechnologies - image_url: https://github.com/appritechnologies.png + url: https://github.com/postkitstack + image_url: https://github.com/postkitstack.png diff --git a/docs/docs/getting-started/installation.md b/docs/docs/getting-started/installation.md index 0777dee..07271e6 100644 --- a/docs/docs/getting-started/installation.md +++ b/docs/docs/getting-started/installation.md @@ -41,7 +41,7 @@ npm --version ### From npm ```bash -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit ``` ### From source diff --git a/docs/docs/intro.mdx b/docs/docs/intro.mdx index eae4bb8..1335a59 100644 --- a/docs/docs/intro.mdx +++ b/docs/docs/intro.mdx @@ -46,7 +46,7 @@ PostKit is built for the Appri stack: ```bash # Install CLI -npm install -g @appritech/postkit +npm install -g @postkitstack/postkit # Initialize a new project postkit init From f0df2b2d667ce0c07f2964fdbab670df77c9ef04 Mon Sep 17 00:00:00 2001 From: Yasiru Geevinda Date: Sat, 29 Aug 2026 11:40:53 +0000 Subject: [PATCH 3/3] fix: encode scoped npm badge URL --- cli/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cli/README.md b/cli/README.md index 4a04afd..c6e7700 100644 --- a/cli/README.md +++ b/cli/README.md @@ -4,7 +4,7 @@ **Note:** This tool is still under development and not recommended for production use. APIs may change between versions. -[![npm version](https://badge.fury.io/js/@postkitstack/postkit.svg)](https://www.npmjs.com/package/@postkitstack/postkit) +[![npm version](https://badge.fury.io/js/%40postkitstack%2Fpostkit.svg)](https://www.npmjs.com/package/@postkitstack/postkit) [![License](https://img.shields.io/npm/l/@postkitstack/postkit.svg)](LICENSE) PostKit CLI is a modular toolkit for backend development with the Appri stack. It provides safe database migrations, auth management, and more.