Set up, update and change the enterprise submodule (`.source/`) and the enterprise packages (`enterprise/packages/*`), including the matching packages-enterprise PR. Use when touching enterprise code or when the submodule needs to be initialized or updated.
88%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Critical
Do not install without reviewing
Use this skill when making changes to the enterprise submodule (.source/) or enterprise packages (enterprise/packages/*), or when the enterprise submodule needs to be initialized/updated.
Novu uses a git submodule at .source pointing to git@github.com:novuhq/packages-enterprise.git. The enterprise packages in enterprise/packages/ have their src directories symlinked to .source/<package>/src.
Configure git for submodule recursion:
git config --global submodule.recurse trueInitialize the submodule:
git submodule update --init --recursiveIf SSH is unavailable (e.g., in cloud environments), configure HTTPS fallback:
git config --global url."https://github.com/".insteadOf "git@github.com:"
gh auth setup-gitAdd enterprise env vars to apps/api/src/.env and apps/worker/src/.env:
NOVU_ENTERPRISE=trueInstall and build with enterprise:
pnpm install:with-ee
pnpm buildinstall:with-ee runs pnpm install then pnpm symlink:submodules which symlinks src dirs from .source/ into enterprise/packages/.
git pull in the main repository (with submodule.recurse=true, submodule changes are fetched but NOT merged).cd .source && git checkout <branch> && git pullfeat/scope-description-fixes-NOV-123). Start from a branch in the submodule, not a detached HEAD..source/: git pushcd into the submodule):
gh pr create --repo novuhq/packages-enterprise --head <branch-name> --base next --title "..." --body "..."https://github.com/novuhq/packages-enterprise/compare/next...<branch-name>gh pr create.gh pr edit the earlier one once the second URL exists.fatal: could not get a repository handle for submodule '.source':
.git/modules/ contentsgit submodule update --init --recursiveUntracked working tree files error on checkout:
git submodule deinit -f enterprisegit submodule update --init --recursiveNuclear option:
pnpm run clean
rm -rf node_modules
pnpm i
pnpm run symlink:submodules
pnpm nx run-many --target=build --all --skip-nx-cache.source directory contains the actual enterprise source code (private repo).enterprise/packages/*/src are symlinks to .source/*/src.@novu/ee-auth, @novu/ee-api, @novu/ee-dal, @novu/ee-billing, @novu/ee-translation, @novu/ee-shared-services.check-ee.mjs script in each enterprise package only builds if the src folder exists (graceful degradation for OSS contributors).novuhq/novu
50f3037
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.