| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 1 | 1 | 0% |
| Commands | 0 | 0 | 0 | — |
| Section tags | 0 | 0 | 4 | 0% |
What each file covers
Sections
0 shared · 1 only in A · 1 only in B- − Dependency Graph
- + Shared Packages Conventions
Commands
neither file has anySection tags
0 shared · 0 only in A · 4 only in B- + code-style
- + architecture
- + dependencies
- + docs
Line diff
novuhq/novu · .cursor/rules/dependency-graph.mdc
@@ −1 @@
1---
2description: Novu monorepo dependency graph — use when assessing blast radius before changing shared code
3globs:
4alwaysApply: false
5---
6
7## Dependency Graph
8
9```mermaid
10graph TD
11 subgraph apps [Apps]
12 api[api]
13 dashboard[dashboard]
14 worker[worker]
15 ws[ws]
16 end
17 subgraph libs [Libs - internal only]
18 dal[dal]
19 appGeneric[application-generic]
20 end
21 subgraph pkgs [Packages - published to NPM]
22 shared[shared]
23 framework[framework]
24 jsSDK[js]
25 reactSDK[react]
26 end
27 api --> appGeneric --> dal
28 worker --> appGeneric
29 ws --> appGeneric
30 api --> shared
31 worker --> shared
32 dashboard --> reactSDK --> jsSDK --> shared
33 dashboard --> framework
34```
35
novuhq/novu · .cursor/rules/packages.mdc
@@ +1 @@
1---
2description: Rules for working in the shared NPM packages
3globs: packages/**/*
4alwaysApply: false
5---
6
7### Shared Packages Conventions
8
9**Public API / semver**
10- Packages are published to NPM — treat all exported symbols as public API.
11- Follow semver: breaking changes require a major bump, new exports are minor, fixes are patch.
12- Deprecate symbols with `@deprecated` JSDoc before removing them.
13
14**`packages/shared`**
15- Contains types, DTOs, enums, and utility functions used across both frontend and backend.
16- Keep this package free of runtime side-effects; it is imported by both Node.js services and browser bundles.
17
18**`packages/framework`**
19- Defines the code-first workflow SDK — the interface between user-defined workflows and Novu's engine.
20- Changes here affect the developer-facing API; write clear, minimal abstractions.
21
22**`packages/providers`**
23- Each provider implements a standard channel interface (e.g., `IEmailProvider`, `ISmsProvider`).
24- New providers must be registered in the provider index and follow the existing file structure.
25
@@ −1 +1 @@
11 ---
2−description: Novu monorepo dependency graph — use when assessing blast radius before changing shared code
3−globs:
2+description: Rules for working in the shared NPM packages
3+globs: packages/**/*
44 alwaysApply: false
55 ---
66
7−## Dependency Graph
7+### Shared Packages Conventions
88
9−```mermaid
10−graph TD
11− subgraph apps [Apps]
12− api[api]
13− dashboard[dashboard]
14− worker[worker]
15− ws[ws]
16− end
17− subgraph libs [Libs - internal only]
18− dal[dal]
19− appGeneric[application-generic]
20− end
21− subgraph pkgs [Packages - published to NPM]
22− shared[shared]
23− framework[framework]
24− jsSDK[js]
25− reactSDK[react]
26− end
27− api --> appGeneric --> dal
28− worker --> appGeneric
29− ws --> appGeneric
30− api --> shared
31− worker --> shared
32− dashboard --> reactSDK --> jsSDK --> shared
33− dashboard --> framework
34−```
9+**Public API / semver**
10+- Packages are published to NPM — treat all exported symbols as public API.
11+- Follow semver: breaking changes require a major bump, new exports are minor, fixes are patch.
12+- Deprecate symbols with `@deprecated` JSDoc before removing them.
13+
14+**`packages/shared`**
15+- Contains types, DTOs, enums, and utility functions used across both frontend and backend.
16+- Keep this package free of runtime side-effects; it is imported by both Node.js services and browser bundles.
17+
18+**`packages/framework`**
19+- Defines the code-first workflow SDK — the interface between user-defined workflows and Novu's engine.
20+- Changes here affect the developer-facing API; write clear, minimal abstractions.
21+
22+**`packages/providers`**
23+- Each provider implements a standard channel interface (e.g., `IEmailProvider`, `ISmsProvider`).
24+- New providers must be registered in the provider index and follow the existing file structure.
3525
