@databiosphere/findable-ui 46.1.3 → 48.1.0

package/.eslintrc.json

@@ -71,7 +71,8 @@
     {
       "files": "**/*.test.ts",
       "rules": {
-        "@typescript-eslint/no-explicit-any": "off"
+        "@typescript-eslint/no-explicit-any": "off",
+        "sonarjs/no-duplicate-string": "off"
       }
     }
   ]

package/.github/copilot-instructions.md

@@ -0,0 +1,176 @@
+# Copilot Instructions for findable-ui
+
+## Repository Purpose
+
+This is a TypeScript library package (`@databiosphere/findable-ui`) that provides reusable UI components and utilities for Data Biosphere applications, particularly the Data Browser. It's designed as an npm package that exports compiled JavaScript from the `lib` directory.
+
+## Key Project Information
+
+- **Language**: TypeScript with strict mode enabled
+- **Node Version**: 20.10.0 (enforced)
+- **UI Framework**: React 18 with Material-UI (MUI) v7
+- **Build System**: TypeScript compiler (tsc)
+- **Testing**: Jest with React Testing Library
+- **Package Type**: Library package that compiles to `lib/` directory
+
+## Repository Structure
+
+- `/src` - TypeScript source files (compiles to `/lib`)
+  - `/components` - React UI components
+  - `/hooks` - Custom React hooks
+  - `/providers` - React context providers
+  - `/utils` - Utility functions
+  - `/theme` - MUI theme configuration
+  - `/config` - Configuration files
+  - `/apis` - API client code
+  - `/services` - Business logic services
+  - `/types` - TypeScript type definitions
+  - `/views` - Page-level components
+- `/tests` - Jest test files (separate from src)
+- `/lib` - Compiled JavaScript output (git-ignored)
+- `/.storybook` - Storybook configuration
+
+## Code Style and Standards
+
+### TypeScript Requirements
+
+- **Strict mode enabled**: All TypeScript strict checks are enforced
+- **Explicit return types required**: All functions must have explicit return type annotations (except in `.styles.ts(x)` files)
+- **No implicit any**: Avoid `any` type; use proper typing (exceptions allowed in test files)
+- **Null safety**: Strict null checks are enforced
+
+### Code Organization
+
+- **Sort keys**: Object keys, destructured keys, interface properties, and string enums must be sorted alphabetically (enforced by ESLint)
+- **Import organization**: Imports are auto-organized with prettier-plugin-organize-imports
+- **File naming**: Use kebab-case for file names (e.g., `my-component.tsx`)
+
+### Documentation Requirements
+
+All code must include JSDoc comments with:
+
+- **Function descriptions**: Required for all functions
+- **Parameter documentation**: `@param` tags with descriptions for all parameters
+- **Return value documentation**: `@returns` tag with description
+- **Hyphen before param descriptions**: Required format
+
+Example:
+
+```typescript
+/**
+ * Transforms a route by removing inactivity parameters.
+ * @param routes - Array of route strings to transform.
+ * @returns The first non-login route without inactivity param, or undefined.
+ */
+function transformRoute(routes: string[]): string | undefined {
+  // implementation
+}
+```
+
+### React Patterns
+
+- **Hooks dependencies**: The `react-hooks/exhaustive-deps` rule is enforced - always include all dependencies in useEffect, useCallback, etc.
+- **Component structure**: Use functional components with hooks
+- **Styling**: Use Emotion styled components (`.styles.ts` or `.styles.tsx` files)
+
+## Build, Test, and Validation Steps
+
+### Before Making Changes
+
+1. Install dependencies: `npm ci`
+2. Run all checks to verify baseline:
+   ```bash
+   npm run check-format
+   npm run lint
+   npm run test
+   npm run test-compile
+   ```
+
+### During Development
+
+1. **Check formatting**: `npm run check-format` (Prettier)
+2. **Lint code**: `npm run lint` (ESLint with TypeScript, SonarJS, and other plugins)
+3. **Run tests**: `npm run test` (Jest with jsdom environment)
+4. **Type check**: `npm run test-compile` (TypeScript compiler without emit)
+5. **Compile library**: `npx tsc` (when making changes that need to be tested in consuming apps)
+
+### All PRs Must Pass
+
+- Prettier formatting check
+- ESLint with no errors
+- All Jest tests passing
+- TypeScript compilation without errors
+
+## Testing Guidelines
+
+- **Test location**: Tests live in the `/tests` directory (not co-located with source files)
+- **Test framework**: Jest with `@testing-library/react` for component tests
+- **Test naming**: Use `.test.ts` or `.test.tsx` extension
+- **Setup**: Tests use Storybook decorators and parameters (see `tests/setup.ts`)
+- **Mocking**: Global mocks for ResizeObserver, TextEncoder, and TextDecoder are pre-configured
+- **Test structure**: Follow the existing pattern of describe/it blocks with clear descriptions
+
+Example test structure:
+
+```typescript
+describe("ComponentName", () => {
+  it("should do something specific", () => {
+    // Arrange
+    const input = "test";
+
+    // Act
+    const result = functionUnderTest(input);
+
+    // Assert
+    expect(result).toBe("expected");
+  });
+});
+```
+
+## Contribution Workflow
+
+1. **Make minimal changes**: This is a library package - changes impact all consumers
+2. **Maintain backward compatibility**: Breaking changes require major version bumps
+3. **Update documentation**: Keep README and inline docs current
+4. **No breaking test changes**: Don't remove or modify existing tests unless fixing bugs
+5. **Test compilation**: Always run `npm run test-compile` to ensure TypeScript compilation succeeds
+
+## Peer Dependencies
+
+This package has extensive peer dependencies that consuming applications must provide:
+
+- React 18.3+
+- Material-UI (@mui/material, @mui/icons-material) v7
+- Next.js 14.2+ and next-auth
+- Emotion (@emotion/react, @emotion/styled)
+- TanStack Table and Virtual (@tanstack/react-table, @tanstack/react-virtual)
+- Various utilities (ky, uuid, yup, etc.)
+
+**Do not add these as direct dependencies** - they must remain as peer dependencies.
+
+## Common Pitfalls to Avoid
+
+1. **Don't import from lib/**: Always import from src/ during development
+2. **Don't add dependencies to dependencies**: New packages should go in peerDependencies or devDependencies
+3. **Don't disable ESLint rules without justification**: The strict rules maintain code quality
+4. **Don't skip JSDoc**: All public functions require documentation
+5. **Don't modify package-lock.json manually**: Use npm commands
+6. **Don't commit lib/ directory**: It's build output and git-ignored
+
+## Special Notes
+
+- **Storybook**: Available for component development (`npm run storybook`)
+- **Husky hooks**: Pre-commit hooks are configured via `.husky`
+- **Release management**: Uses release-please for automated versioning and changelog
+- **Link for local development**: Use `npm link` to test changes in Data Browser locally (see README)
+
+## Development with Data Browser
+
+When developing findable-ui alongside the Data Browser:
+
+1. Clone both repos in the same parent directory
+2. In findable-ui: Run `npm ci`, bump version, run `npx tsc`
+3. In data-browser/explorer: Run `npm link ../../findable-ui`
+4. May need to comment out certain packages in next.config.mjs webpack config
+
+See README.md for complete local development workflow.

package/.github/workflows/release-please.yml

@@ -7,6 +7,7 @@ on:
 permissions:
   contents: write
   pull-requests: write
+  id-token: write # Required for trusted publishing to npm
 
 name: release-please
 
@@ -27,8 +28,13 @@ jobs:
       - uses: actions/setup-node@v4
         if: ${{ steps.release.outputs.release_created }}
         with:
-          node-version: 20
+          node-version: "22.12.0"
           registry-url: "https://registry.npmjs.org"
+          always-auth: true # Enable authentication for trusted publishing
+
+      - name: Upgrade npm for trusted publishing
+        if: ${{ steps.release.outputs.release_created }}
+        run: npm install -g npm@^11.5.1
 
       - name: Install dependencies
         if: ${{ steps.release.outputs.release_created }}
@@ -38,8 +44,28 @@ jobs:
         if: ${{ steps.release.outputs.release_created }}
         run: npx tsc
 
+      - name: Debug OIDC Token
+        if: ${{ steps.release.outputs.release_created }}
+        run: |
+          echo "=== OIDC Debug Info ==="
+          echo "Repository: $GITHUB_REPOSITORY"
+          echo "Workflow: $GITHUB_WORKFLOW"
+          echo "Job: $GITHUB_JOB"
+          echo "Run ID: $GITHUB_RUN_ID"
+          echo "Ref: $GITHUB_REF"
+          echo "Token URL available: ${{ env.ACTIONS_ID_TOKEN_REQUEST_URL != '' }}"
+          echo "=== Requesting OIDC token for npm ==="
+          if [ -n "$ACTIONS_ID_TOKEN_REQUEST_URL" ]; then
+            if OIDC_RESPONSE=$(curl -sS -H "Authorization: bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
+              "$ACTIONS_ID_TOKEN_REQUEST_URL&audience=npm" 2>/dev/null); then
+              echo "✓ OIDC token request succeeded"
+            else
+              echo "✗ Failed to get OIDC token"
+            fi
+          else
+            echo "✗ ACTIONS_ID_TOKEN_REQUEST_URL is not set - id-token permission may be missing"
+          fi
+
       - name: Publish to NPM
         if: ${{ steps.release.outputs.release_created }}
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.DATABIOSPHERE_FINDABLE_UI_NPM_PUBLISH_TOKEN }} # Ensure this token is scoped to only the permissions required for npm publication to limit security risks.
+        run: npm publish --provenance --access public

package/.github/workflows/run-checks.yml

@@ -14,7 +14,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "20.10.0"
+          node-version: "22.12.0"
           cache: "npm"
 
       - name: Install dependencies
@@ -41,7 +41,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "20.10.0"
+          node-version: "22.12.0"
           cache: "npm"
 
       - name: Remove package lock

package/.husky/pre-commit

@@ -27,6 +27,13 @@ npm test ||
 	false;
 )
 
+# Check Black (Python formatter)
+python -m black backend --check ||
+(
+	echo '🤔 Black Check Failed. Run: python -m black backend';
+	false;
+)
+
 # Check TypeScript
 npm run test-compile ||
 (

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "46.1.3"
+  ".": "48.1.0"
 }

package/.storybook/main.ts

@@ -1,52 +1,10 @@
-import { StorybookConfig } from "@storybook/nextjs";
-import * as path from "path";
+import { defineMain } from "@storybook/nextjs-vite/node";
 
-const toPath = (filePath: string) => path.join(process.cwd(), filePath);
-
-const config: StorybookConfig = {
+export default defineMain({
+  framework: "@storybook/nextjs-vite",
+  stories: ["../src/**/*.mdx", "../src/**/*.stories.@(js|jsx|mjs|ts|tsx)"],
   core: {
+    builder: "@storybook/builder-vite",
     disableTelemetry: true,
   },
-  stories: ["../src/**/*.stories.mdx", "../src/**/*.stories.@(js|jsx|ts|tsx)"],
-  addons: [
-    "@storybook/addon-links",
-    "@storybook/addon-essentials",
-    "@storybook/addon-interactions",
-    "@storybook/addon-mdx-gfm",
-  ],
-  typescript: {
-    reactDocgen: "react-docgen-typescript",
-    reactDocgenTypescriptOptions: {
-      shouldExtractLiteralValuesFromEnum: true,
-      // Filter out third-party props from node_modules except @mui packages
-      propFilter: (prop: any) =>
-        prop.parent
-          ? !/node_modules\/(?!@mui)/.test(prop.parent.fileName)
-          : true,
-    },
-  },
-  framework: {
-    name: "@storybook/nextjs",
-    options: {},
-  },
-  webpackFinal: async (config: any) => {
-    return {
-      ...config,
-      resolve: {
-        ...config.resolve,
-        alias: {
-          ...config.resolve.alias,
-          app: path.resolve(__dirname, "../src"),
-          //images: path.resolve(__dirname, "../images"),
-          "@emotion/core": toPath("node_modules/@emotion/react"),
-          "emotion-theming": toPath("node_modules/@emotion/react"),
-        },
-      },
-    };
-  },
-  docs: {
-    autodocs: true,
-  },
-};
-
-export default config;
+});

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## [48.1.0](https://github.com/DataBiosphere/findable-ui/compare/v48.0.0...v48.1.0) (2026-01-11)
+
+
+### Features
+
+* add debug messages to rp ([#762](https://github.com/DataBiosphere/findable-ui/issues/762)) ([#763](https://github.com/DataBiosphere/findable-ui/issues/763)) ([eb1454a](https://github.com/DataBiosphere/findable-ui/commit/eb1454a22bc27efa85e3b672330a32a775ae9763))
+
+## [48.0.0](https://github.com/DataBiosphere/findable-ui/compare/v47.0.2...v48.0.0) (2026-01-06)
+
+
+### ⚠ BREAKING CHANGES
+
+* next.js to v15.x (step towards v16) ([#714](https://github.com/DataBiosphere/findable-ui/issues/714)) (#759)
+
+### Features
+
+* added facets endpoint [#737](https://github.com/DataBiosphere/findable-ui/issues/737) ([#741](https://github.com/DataBiosphere/findable-ui/issues/741)) ([c7d4445](https://github.com/DataBiosphere/findable-ui/commit/c7d444576d3c609c5212cb8cf7a18bb64f48df4d))
+
+
+### Bug Fixes
+
+* fix "window is not defined" error in usewindowresize hook ([#742](https://github.com/DataBiosphere/findable-ui/issues/742)) ([#743](https://github.com/DataBiosphere/findable-ui/issues/743)) ([44c42a2](https://github.com/DataBiosphere/findable-ui/commit/44c42a2fb7163f710ab07991a0faef1470438559))
+
+
+### Chores
+
+* add claude.md for ([#739](https://github.com/DataBiosphere/findable-ui/issues/739)) ([#740](https://github.com/DataBiosphere/findable-ui/issues/740)) ([969b484](https://github.com/DataBiosphere/findable-ui/commit/969b4844b83725128133abf83c378125a8d78880))
+* next.js to v15.x (step towards v16) ([#714](https://github.com/DataBiosphere/findable-ui/issues/714)) ([#759](https://github.com/DataBiosphere/findable-ui/issues/759)) ([b312990](https://github.com/DataBiosphere/findable-ui/commit/b31299036707559f07271e38fc978ae8a513c157))
+* upgrade storybook to latest version ([#733](https://github.com/DataBiosphere/findable-ui/issues/733)) ([#734](https://github.com/DataBiosphere/findable-ui/issues/734)) ([b419e22](https://github.com/DataBiosphere/findable-ui/commit/b419e2226768c6182191a0936955b7ed98cfcfc3))
+
+## [47.0.2](https://github.com/DataBiosphere/findable-ui/compare/v47.0.1...v47.0.2) (2025-12-11)
+
+
+### Chores
+
+* remove trailing whitespace from README to trigger release ([#728](https://github.com/DataBiosphere/findable-ui/issues/728)) ([5f24174](https://github.com/DataBiosphere/findable-ui/commit/5f24174aed98fc54429e939d9b63c542f1cce0b8))
+
+## [47.0.1](https://github.com/DataBiosphere/findable-ui/compare/v47.0.0...v47.0.1) (2025-12-11)
+
+
+### Chores
+
+* add GitHub Copilot instructions for repository ([#709](https://github.com/DataBiosphere/findable-ui/issues/709)) ([#710](https://github.com/DataBiosphere/findable-ui/issues/710)) ([e2bf4fb](https://github.com/DataBiosphere/findable-ui/commit/e2bf4fb81b46fc1376c7797141fc41a8a6029c9f))
+
+## [47.0.0](https://github.com/DataBiosphere/findable-ui/compare/v46.1.3...v47.0.0) (2025-12-11)
+
+
+### ⚠ BREAKING CHANGES
+
+* upgrade Node.js from 20.10.0 to 22.12.0 ([#713](https://github.com/DataBiosphere/findable-ui/issues/713)) (#716)
+
+### Chores
+
+* update the package-lock ([#720](https://github.com/DataBiosphere/findable-ui/issues/720)) ([#721](https://github.com/DataBiosphere/findable-ui/issues/721)) ([6cf79a9](https://github.com/DataBiosphere/findable-ui/commit/6cf79a9b18ac39365b92ae041df1ab67fe825434))
+* upgrade Node.js from 20.10.0 to 22.12.0 ([#713](https://github.com/DataBiosphere/findable-ui/issues/713)) ([#716](https://github.com/DataBiosphere/findable-ui/issues/716)) ([26d97dd](https://github.com/DataBiosphere/findable-ui/commit/26d97dd951c65099b5e868ead0b03205eb15235a))
+
 ## [46.1.3](https://github.com/DataBiosphere/findable-ui/compare/v46.1.2...v46.1.3) (2025-12-01)
 
 

package/CLAUDE.md

@@ -0,0 +1,214 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This is a TypeScript library package (`@databiosphere/findable-ui`) that provides reusable UI components and utilities for Data Biosphere applications, particularly the Data Browser. It compiles TypeScript source from `src/` to JavaScript in `lib/` for distribution as an npm package.
+
+**Key Facts:**
+
+- **Node Version:** 22.12.0 (enforced by package.json)
+- **UI Framework:** React 18 with Material-UI v7 and Emotion for styling
+- **Build System:** TypeScript compiler (`tsc`) with strict mode enabled
+- **Import Pattern:** External apps import as `@databiosphere/findable-ui/lib/<path>`
+
+## Development Commands
+
+### Essential Commands
+
+```bash
+# Install dependencies (use ci for clean install)
+npm ci
+
+# Compile TypeScript to lib/ directory
+npx tsc
+
+# Run all validation checks
+npm run check-format  # Prettier formatting check
+npm run lint          # ESLint with TypeScript and SonarJS plugins
+npm run test          # Jest with React Testing Library
+npm run test-compile  # TypeScript compilation check (no emit)
+
+# Development tools
+npm run storybook     # Launch Storybook on port 6006
+```
+
+### Running Single Tests
+
+```bash
+# Run specific test file
+npm test -- path/to/file.test.ts
+
+# Run tests in watch mode
+npm test -- --watch
+```
+
+### Local Development with Data Browser
+
+When developing alongside the Data Browser:
+
+1. Clone both repos in the same parent directory
+2. In findable-ui: `npm update && npx tsc`
+3. In data-browser/explorer: `npm link ../findable-ui`
+4. Rerun `npm link` if you install/uninstall packages (symlink gets removed)
+5. May need to comment out `@tanstack/react-table` in Data Browser's `next.config.mjs` webpack config
+
+**Important:** Run `npx tsc` whenever you make changes to source files that need testing in consuming apps.
+
+## Code Architecture
+
+### Directory Structure
+
+- **`/src`** - TypeScript source (compiles to `/lib`)
+  - `/components` - React UI components (organized by feature)
+  - `/hooks` - Custom React hooks (useAsync, useExploreMode, etc.)
+  - `/providers` - React context providers for state management
+  - `/theme` - MUI theme configuration
+  - `/config` - Configuration entities and utilities
+  - `/apis` - API client code (e.g., Azul API integration)
+  - `/entity` - Entity service layer (api, service, common, tsv, apicf subdirectories)
+  - `/viewModelBuilders` - Transform API responses to view models
+  - `/views` - Page-level components
+  - `/utils` - Utility functions
+  - `/types` - TypeScript type definitions
+  - `/routes` - Routing utilities
+  - `/services` - Business logic services
+  - `/common` - Shared utilities (analytics, categories, filters, etc.)
+  - `/styles` - Global styles
+- **`/tests`** - Jest test files (separate from src, not co-located)
+- **`/lib`** - Compiled JavaScript output (git-ignored, generated by tsc)
+
+### Key Architectural Patterns
+
+**Entity Service Layer:** The `/entity` directory contains a service-oriented architecture for data fetching and transformation:
+
+- `api/` - API-based entity services
+- `service/` - Service factory and models
+- `common/` - Shared client utilities
+- `tsv/` - TSV-specific services
+- `apicf/` - API custom field services
+
+**Configuration-Driven Components:** Many components are driven by config objects defined in `/config/entities.ts`. This includes analytics, authentication, export methods, and layout configuration.
+
+**Provider Architecture:** State management uses React Context providers (authentication, exploreState, fileManifestState, dataDictionary, etc.) located in `/providers`.
+
+**Analytics:** Google Analytics 4 integration via `src/common/analytics/`. Events are defined in entities.ts and tracked via the `track` function. See `src/common/analytics/readme-analytics.md` for event inventory.
+
+## Code Style Requirements
+
+### TypeScript Standards
+
+**Strict Mode Enforcement:**
+
+- All TypeScript strict checks enabled
+- **Explicit return types required** for all functions (except `.styles.ts(x)` files)
+- No `any` type (exceptions allowed in test files)
+- Strict null checks enforced
+
+**Sorting Requirements (ESLint enforced):**
+
+- Object keys must be sorted alphabetically
+- Destructured keys must be sorted
+- Interface properties must be sorted
+- String enums must be sorted
+- Imports auto-organized by prettier-plugin-organize-imports
+
+**File Naming:** Use kebab-case (e.g., `my-component.tsx`)
+
+### JSDoc Documentation
+
+**Required for all functions:**
+
+```typescript
+/**
+ * Transforms a route by removing inactivity parameters.
+ * @param routes - Array of route strings to transform.
+ * @returns The first non-login route without inactivity param, or undefined.
+ */
+function transformRoute(routes: string[]): string | undefined {
+  // implementation
+}
+```
+
+**Requirements:**
+
+- Function description
+- `@param` tags with descriptions (hyphen required before description)
+- `@returns` tag with description
+
+### React Patterns
+
+- Use functional components with hooks
+- **react-hooks/exhaustive-deps is enforced** - include all dependencies in useEffect, useCallback, useMemo
+- Styling: Use Emotion styled components in `.styles.ts` or `.styles.tsx` files
+- Component structure: Keep components focused and single-responsibility
+
+## Testing
+
+**Test Location:** Tests live in `/tests` directory (not co-located with source)
+
+**Test Framework:** Jest with `@testing-library/react` in jsdom environment
+
+**Test Naming:** Use `.test.ts` or `.test.tsx` extension
+
+**Global Mocks:** Pre-configured for ResizeObserver, TextEncoder, TextDecoder (see `tests/setup.ts`)
+
+**Test Structure:**
+
+```typescript
+describe("ComponentName", () => {
+  it("should do something specific", () => {
+    // Arrange
+    const input = "test";
+
+    // Act
+    const result = functionUnderTest(input);
+
+    // Assert
+    expect(result).toBe("expected");
+  });
+});
+```
+
+## Dependency Management
+
+**This is a library package - use peer dependencies carefully.**
+
+**Peer Dependencies:** Consuming applications must provide:
+
+- React 18.3+
+- Material-UI v7 (@mui/material, @mui/icons-material)
+- Next.js 14.2+ and next-auth
+- Emotion (@emotion/react, @emotion/styled)
+- TanStack Table and Virtual
+- Various utilities (ky, uuid, yup, etc.)
+
+**Critical:** New dependencies should go in `peerDependencies` or `devDependencies`, NOT `dependencies`.
+
+## Pre-Commit and CI Checks
+
+**All PRs must pass:**
+
+- Prettier formatting (`npm run check-format`)
+- ESLint with no errors (`npm run lint`)
+- All Jest tests passing (`npm test`)
+- TypeScript compilation (`npm run test-compile`)
+
+**Husky hooks:** Pre-commit hooks configured in `.husky/`
+
+## Common Pitfalls
+
+1. **Don't import from lib/** - Always import from `src/` during development
+2. **Don't add to dependencies** - Use peerDependencies or devDependencies
+3. **Don't disable ESLint rules** without justification
+4. **Don't skip JSDoc** - Required for all public functions
+5. **Don't commit lib/ directory** - It's build output and git-ignored
+6. **Don't skip return types** - Explicit return types required (except .styles files)
+7. **Maintain backward compatibility** - This is a library; breaking changes require major version bumps
+
+## Special Notes
+
+- **Release Management:** Uses release-please for automated versioning and changelog
+- **Storybook:** Available for component development and visual testing
+- **Import Paths:** Base URL is `./src` (configured in tsconfig.json), allowing absolute imports within src

package/README.md

@@ -12,24 +12,18 @@
 
 1. Clone this repository into the same parent folder as
    the [Data Biosphere Data Browser](https://github.com/DataBiosphere/data-browser).
-2. Set `node` version to `20.10.0` (this is also the version used by the Data Browser).
+2. Set `node` version to `22.12.0` (this is also the version used by the Data Browser).
 3. In the `findable-ui` repository directory:
-    - Run `npm ci`.
-    - [Bump the version number](https://docs.npmjs.com/cli/v6/commands/npm-version) in `package.json`
-      e.g. `npm version <update_type>`.
+    - Run `npm update`.
     - Run `npx tsc` (this should be run when this repository is first downloaded and when any changes are made to the
       source files; one way this can be done more efficiently is
       by [setting the default build task](https://code.visualstudio.com/docs/typescript/typescript-compiling#_step-3-make-the-typescript-build-the-default)
       in VS Code so that it can be done with a keyboard shortcut).
 4. In the Data Browser `explorer` directory (e.g. `data-browser/explorer`):
-    - Run `npm ci`.
-    - Update the `@databiosphere/findable-ui` dependency in the `package.json` file to use the new version
-      of Findable UI.
-    - Run `npm link ../../findable-ui`, which will create a symlink in node_modules pointing
+    - Run `npm update`.
+    - Run `npm link ../findable-ui`, which will create a symlink in node_modules pointing
       to findable-ui.
     - If any packages are later installed or uninstalled, the symlink will need to be created again, which can be done
       with the same command or by running `npm link @databiosphere/findable-ui`. 
     - To successfully link to findable-ui, you may need to comment out the following packages from the `next.config.mjs` webpack configuration:
       - `@tanstack/react-table`
-      - `axios`
-