@checkstack/pluginmanager-frontend 0.2.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,91 @@
1
1
  # @checkstack/pluginmanager-frontend
2
2
 
3
+ ## 0.3.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [9016526]
8
+ - @checkstack/common@0.10.0
9
+ - @checkstack/frontend-api@0.5.1
10
+ - @checkstack/pluginmanager-common@0.2.2
11
+ - @checkstack/tips-frontend@0.2.1
12
+ - @checkstack/ui@1.8.1
13
+
14
+ ## 0.3.0
15
+
16
+ ### Minor Changes
17
+
18
+ - 3547670: Wire the new tips infrastructure across the frontends:
19
+
20
+ **Empty-state coaching.** Replace generic "no items" copy with onboarding
21
+ guidance — short description, three numbered steps and a primary CTA — on
22
+ every EmptyState that has a meaningful next action. Affects: catalog
23
+ (systems + groups), dashboard, health-check page, integrations (subscriptions
24
+
25
+ - provider connections), GitOps providers + secrets, GitOps provenance,
26
+ SLO config + overview, maintenance config, satellites, plugin manager,
27
+ incident config, announcements. Read-only EmptyStates (incident history,
28
+ maintenance history, plugin events) get clearer descriptions explaining
29
+ what would populate them.
30
+
31
+ **First-run anchored tips.** Add `<Tip>` popovers to the most important
32
+ "Create" affordances so first-time users see a one-line explanation of
33
+ what they're about to make and why it matters: catalog “Add System” /
34
+ “Add Group”, healthcheck “Create Check”, integrations “New Subscription”,
35
+ GitOps “Add Provider”, SLO “Create SLO”, maintenance “Create Maintenance”,
36
+ satellite “Create Satellite”, plugin-manager “Install plugin”, incident
37
+ “Report Incident”, announcement “New Announcement”. Each tip is dismissed
38
+ per user (server-backed when signed in, localStorage otherwise) and
39
+ namespaced through `qualifyTipId(plugin, …)` so it cannot escape the
40
+ plugin's own namespace.
41
+
42
+ **Welcome banner on the dashboard.** A `<TipBanner>` at the top of the
43
+ dashboard introduces Checkstack's main flow ("add a system, then a health
44
+ check") with a one-click jump into the catalog.
45
+
46
+ ### Patch Changes
47
+
48
+ - 950d6ec: Fix mobile UserMenu items rendering at zero height, group menu items by
49
+ section, and unstack cramped card headers on small viewports.
50
+
51
+ - **UserMenu mobile bug**: On mobile, the user-menu Sheet rendered every
52
+ menu item as a grid row, which combined with `flex-shrink: 1` on each
53
+ item collapsed the buttons whose internal layout uses `display: flex`
54
+ (the items registered with `useNavigate` rather than `<Link>`) to zero
55
+ content height. Switched the mobile container to a flex column with
56
+ `[&>*]:shrink-0` and added `min-h-0` so the sheet scrolls correctly
57
+ when the list overflows.
58
+
59
+ - **UserMenu grouping**: Slot extensions now accept an optional `group`
60
+ field. The user menu buckets `UserMenuItemsSlot` extensions by `group`
61
+ and renders each group under a labeled header (`Workspace`,
62
+ `Reliability`, `Configuration`, `Documentation`, `Account`). Existing
63
+ core plugins are tagged with the appropriate group; third-party plugins
64
+ can pick any of these or supply their own label. Untagged extensions
65
+ render last with no header. `UserMenuItemsBottomSlot` is unaffected.
66
+
67
+ - **Card header responsiveness**: `CardHeaderRow` (the primitive shared by
68
+ Incident, Maintenance, Auth, Catalog, GitOps and other config cards) now
69
+ stacks vertically on narrow viewports and only switches to a single row
70
+ at the `sm` breakpoint, so titles and adjacent filter controls (e.g.
71
+ status `Select`, "Show resolved" checkbox) no longer cram together on
72
+ mobile. Refactored the Incident and Maintenance config pages to use the
73
+ primitive instead of a hand-rolled `flex items-center justify-between`
74
+ row, and made their `Select` triggers full-width on mobile.
75
+
76
+ - Updated dependencies [42abfff]
77
+ - Updated dependencies [3547670]
78
+ - Updated dependencies [1ef2e79]
79
+ - Updated dependencies [aa89bc5]
80
+ - Updated dependencies [3547670]
81
+ - Updated dependencies [950d6ec]
82
+ - Updated dependencies [3547670]
83
+ - @checkstack/common@0.9.0
84
+ - @checkstack/ui@1.8.0
85
+ - @checkstack/frontend-api@0.5.0
86
+ - @checkstack/tips-frontend@0.2.0
87
+ - @checkstack/pluginmanager-common@0.2.1
88
+
3
89
  ## 0.2.0
4
90
 
5
91
  ### Minor Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@checkstack/pluginmanager-frontend",
3
- "version": "0.2.0",
3
+ "version": "0.3.1",
4
4
  "license": "Elastic-2.0",
5
5
  "type": "module",
6
6
  "main": "src/index.tsx",
@@ -13,18 +13,19 @@
13
13
  "lint:code": "eslint . --max-warnings 0"
14
14
  },
15
15
  "dependencies": {
16
- "@checkstack/pluginmanager-common": "0.1.0",
17
- "@checkstack/frontend-api": "0.4.1",
18
- "@checkstack/common": "0.7.0",
19
- "@checkstack/ui": "1.7.0",
16
+ "@checkstack/common": "0.9.0",
17
+ "@checkstack/frontend-api": "0.5.0",
18
+ "@checkstack/pluginmanager-common": "0.2.1",
19
+ "@checkstack/tips-frontend": "0.2.0",
20
+ "@checkstack/ui": "1.8.0",
21
+ "lucide-react": "^0.344.0",
20
22
  "react": "^18.2.0",
21
- "react-router-dom": "^6.22.0",
22
- "lucide-react": "^0.344.0"
23
+ "react-router-dom": "^6.22.0"
23
24
  },
24
25
  "devDependencies": {
25
26
  "typescript": "^5.0.0",
26
27
  "@types/react": "^18.2.0",
27
- "@checkstack/tsconfig": "0.0.6",
28
- "@checkstack/scripts": "0.1.2"
28
+ "@checkstack/tsconfig": "0.0.7",
29
+ "@checkstack/scripts": "0.3.1"
29
30
  }
30
31
  }
package/src/index.tsx CHANGED
@@ -39,6 +39,7 @@ export default createFrontendPlugin({
39
39
  id: "pluginmanager.user-menu.link",
40
40
  slot: UserMenuItemsSlot,
41
41
  component: PluginManagerMenuItem,
42
+ metadata: { group: "Configuration" },
42
43
  },
43
44
  ],
44
45
  });
@@ -32,8 +32,10 @@ import {
32
32
  PluginManagerApi,
33
33
  pluginManagerAccess,
34
34
  pluginManagerRoutes,
35
+ pluginMetadata as pluginManagerMetadata,
35
36
  type InstalledPlugin,
36
37
  } from "@checkstack/pluginmanager-common";
38
+ import { Tip } from "@checkstack/tips-frontend";
37
39
  import { TypedConfirmModal } from "../components/TypedConfirmModal";
38
40
 
39
41
  const InstalledPluginsPageContent: React.FC = () => {
@@ -81,12 +83,21 @@ const InstalledPluginsPageContent: React.FC = () => {
81
83
  Events
82
84
  </Link>
83
85
  </Button>
84
- <Button asChild>
85
- <Link to={installPath}>
86
- <Plus className="w-4 h-4 mr-2" />
87
- Install plugin
88
- </Link>
89
- </Button>
86
+ <Tip
87
+ plugin={pluginManagerMetadata}
88
+ id="install"
89
+ title="Extend Checkstack at runtime"
90
+ description="Plugins add new health-check protocols, notification channels, integrations, even auth backends — without rebuilding the platform. Install one from npm, a GitHub release, or upload a tarball directly."
91
+ side="bottom"
92
+ align="end"
93
+ >
94
+ <Button asChild>
95
+ <Link to={installPath}>
96
+ <Plus className="w-4 h-4 mr-2" />
97
+ Install plugin
98
+ </Link>
99
+ </Button>
100
+ </Tip>
90
101
  </div>
91
102
  );
92
103
 
@@ -125,8 +136,22 @@ const InstalledPluginsPageContent: React.FC = () => {
125
136
  <CardContent>
126
137
  {plugins.length === 0 ? (
127
138
  <EmptyState
128
- title="No plugins"
129
- description="No plugins discovered yet."
139
+ icon={<Puzzle className="size-10" />}
140
+ title="No plugins discovered yet"
141
+ description="Almost everything in Checkstack is a plugin — health-check protocols, notification channels, integrations, even auth backends. New ones can be installed at runtime from npm, a GitHub release, or a tarball you upload."
142
+ steps={[
143
+ "Click “Install plugin” to add a runtime plugin (e.g. a custom notification channel).",
144
+ "Drop in a tarball, paste an npm package name, or point at a GitHub release.",
145
+ "Bundled platform plugins always show up here too — they're read-only and managed by the Checkstack release.",
146
+ ]}
147
+ actions={
148
+ <Button asChild>
149
+ <Link to={installPath}>
150
+ <Plus className="w-4 h-4 mr-2" />
151
+ Install plugin
152
+ </Link>
153
+ </Button>
154
+ }
130
155
  />
131
156
  ) : (
132
157
  <Table>
@@ -57,8 +57,8 @@ const PluginEventsPageContent: React.FC = () => {
57
57
  {events.length === 0 ? (
58
58
  <EmptyState
59
59
  icon={<History className="w-12 h-12" />}
60
- title="No events yet"
61
- description="Plugin install/uninstall lifecycle events will show up here."
60
+ title="No plugin events yet"
61
+ description="Whenever a plugin is installed, uninstalled, enabled, or fails to load, the lifecycle event lands here with phase, status and any error message. Useful for diagnosing why a freshly installed plugin didn't show up where you expected."
62
62
  />
63
63
  ) : (
64
64
  <Card>
package/tsconfig.json CHANGED
@@ -13,6 +13,9 @@
13
13
  {
14
14
  "path": "../pluginmanager-common"
15
15
  },
16
+ {
17
+ "path": "../tips-frontend"
18
+ },
16
19
  {
17
20
  "path": "../ui"
18
21
  }