Kappmaker Refactor

Name: Kappmaker Refactor
Author: KAppMaker

ASecurity

Rename a KAppMaker app's package name, bundle ID or display name across the codebase. Use when the user asks to rename the app or change the package name or bundle identifier.

3 stars
0 votes
0 copies
5 views
Added September 3, 2026

developmentkotlinrefactoringgit

Works with

Security analysis

A92/100

mediumInstalls packages at runtime which could introduce malicious dependencies

Pro shows the line behind each finding and how to fix it

Scanned September 3, 2026

npx -y skills add KAppMaker/KAppMaker-CLI --skill kappmaker-refactor --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Kappmaker Refactor?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Kappmaker Refactor

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/kappmaker-kappmaker-refactor/badge)](https://www.skillsdirectory.com/skills/kappmaker-kappmaker-refactor)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: kappmaker-refactor
description: Rename a KAppMaker app's package name, bundle ID or display name across the codebase. Use when the user asks to rename the app or change the package name or bundle identifier.
---

# KAppMaker — Refactor

## Before running any command

1. **Prerequisites** — `kappmaker --version` (install: `npm i -g kappmaker`). If a credential is
   missing the CLI says so; re-run `kappmaker config init`.
2. **Read `AiGuidelines/` first** — the PRD, positioning and UI spec already answer most questions.


### refactor — Package & App Name Refactoring

**Syntax**: `kappmaker refactor --app-id <id> --app-name <name> [options]`

**Options**:
- `--app-id <id>` (required) — New applicationId / bundleId (e.g., `com.example.myapp`)
- `--app-name <name>` (required) — New display name (e.g., `MyApp`)
- `--old-app-id <id>` — Current applicationId to replace (default: `com.measify.kappmaker`)
- `--old-app-name <name>` — Current app name to replace (default: `KAppMakerAllModules`)
- `--skip-package-rename` — Only update IDs and app name, keep Kotlin package directories intact

**Prerequisites**: None. Run from the project root (containing `MobileApp/`) or inside `MobileApp/`.

**What it does**:
- **Full refactor** (default): Renames Kotlin packages in all source sets, moves directories, updates Gradle files, Firebase configs, iOS project files, GitHub workflows, and app display name.
- **Skip-package-rename mode**: Only updates applicationId/bundleId, Firebase configs, iOS files, workflows, and app name — keeps Kotlin package dirs intact. Useful for creating multiple apps from one codebase.

**Re-refactoring**: To refactor a project that was already refactored, pass `--old-app-id` and `--old-app-name` with the current values:
```
kappmaker refactor --app-id com.new.app --app-name NewApp --old-app-id com.previous.app --old-app-name PreviousApp
```

---

## Where this sits in the flow

- **Before this:** Do this EARLY, before any store record exists — the package name and bundle ID are what **kappmaker-asc** and **kappmaker-gpc** register.
- **After this:** Rebuild and re-run **kappmaker-publish**.