Repository navigation
Redesign the README and fix the library's Tailwind build - #4
Merged
Merged
Conversation
- tailwind.config.js (left over from the old Electron app) won Tailwind's lookup order, so dist/styles.css and Storybook compiled bg-primary to an undefined var(--primary) and never generated bg-card - Point the CLI (-c) and the PostCSS plugin at tailwind.config.ts, which maps every token to the library's --ou-* variables - index.js, index.cjs and index.d.ts are byte-identical; only the CSS changes Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5
- npm run lint failed with 126 errors, all in Uplift Assistant files whose dependencies left package.json in April 2026; none in the library - Exclude those paths in tsconfig.json with a comment saying why - npm run lint now exits 0, and the declaration build no longer emits stray .d.ts files for components/ui, components/auth, lib/supabase and lib/timeout Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5
- Banner, Storybook walkthrough and build flow cards in docs/readme/ - Mark the library superseded and the old Electron app archived, with the platform it belonged to - Correct claims the code contradicts: the package is not on npm, no app imported it, 49 components and 17 hooks (not 47 and 13), and the useMemory example used return values that do not exist - Replace the npm install step with a verified build, pack and install path - Move tokens, hooks, memory, layout and the component tables into collapsible sections Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
The README described a published package used by three apps. The code says otherwise, and the library's own stylesheet was being compiled from the wrong Tailwind config. This rebuilds the README in the same house style as the pilot (allowance) and fixes the two build problems in separate commits.
src/.Corrections to the old README
npm install @operatoruplift/uicannot work: the package was never published (npm view @operatoruplift/uireturns E404). Replaced with build,npm pack, install the tarball, which I checked in a scratch app.entries,addMemoryandsearchMemories, whichuseMemorydoes not return. The new example usesindex,save,searchandremove, and type-checks."use client", and a packed build renders throughreact-dom/server.Fixes
postcss.config.js,package.json): Tailwind 3 looks fortailwind.config.jsbeforetailwind.config.ts, and the.jsfile belongs to the old Electron app. Sodist/styles.cssand Storybook compiledbg-primarytovar(--primary), which the library never defines, and never generatedbg-card: primary and danger buttons had no fill and cards had no surface. Both now nametailwind.config.ts.dist/index.js,index.cjsandindex.d.tsare byte-identical before and after; only the CSS changes.tsconfig.json):npm run lintfailed with 126 errors, every one in the old app's files (react-router-dom, zustand, electron and others leftpackage.jsonin April 2026). Those 163 files are now excluded, with a comment. As a side effect the declaration build stops emitting.d.tsfiles for code the package does not contain.Checks
Run on 30 October 2026 with Node 22.22.0 and npm 10.9.4:
npm ci: 445 packages installed.npm run lint: 126 errors before (all outside the library), exit 0 after.npm test: 26 files, 119 of 119 tests pass, before and after.npm run build: passes. After the fix,dist/styles.csscontains.bg-primary{background-color:var(--ou-primary)}and.bg-card{background-color:var(--ou-card)}.npx storybook build: builds all 168 stories. Before and after captures of the Button story confirm the primary and danger colors were missing and are now back.npm pack, then install into a scratch app with React 18. ESM and CommonJS imports work,styles.cssand the preset resolve, aButtonrenders withreact-dom/server, the README's three code samples passtscwithskipLibCheckoff, and Tailwind with the preset emits the token classes.check.mjs): no errors. Preview reviewed in light and dark.Not fixed
bg-primary/20,ring-primary/50and similar) still generate no CSS, because the tokens are plainvar()colors without<alpha-value>. This happened with both configs. Fixing it changes the token format, so it is left for you; the README documents it.src/. Deleting them is your call.CLAUDE.mdsays Tailwind CSS 4; the library uses Tailwind 3.4.Suggested repository settings
These live outside the code, so they are not in this PR:
react,component-library,storybook,tailwindcss,design-tokens,typescriptdocs/readme/banner.png(2400 × 1200) under Settings → General → Social preview.Generated by Claude Code