Skip to content

docs: minor site improvements - #326

Merged
vitonsky merged 37 commits into
masterfrom
325-minor-site-improvements
Jun 20, 2026
Merged

docs: minor site improvements#326
vitonsky merged 37 commits into
masterfrom
325-minor-site-improvements

Conversation

@vitonsky

@vitonsky vitonsky commented Jun 18, 2026

Copy link
Copy Markdown
Member

Closes #325

Summary by CodeRabbit

  • Style
    • Updated link, Markdown, and theme visuals to use design tokens (including hover/blockquote/image borders, selection styling, and code block selection).
    • Refined input and Note editor header/tab sizing.
  • New Features
    • Added a visual separator to the Download page layout.
  • Bug Fixes
    • Improved release display names by deriving them from tag versions (with fallback).
    • Note links now open using the preview flow.
    • Improved language folder detection and error logging for alt version generation.
  • Refactor
    • Removed the note archive control from the editor toolbar.
  • Documentation
    • Added new pages for Vaults, Workspaces, Snapshots, Import & Export, and Organizing Notes.
    • Updated encryption documentation links and site sidebar structure.

@vitonsky vitonsky linked an issue Jun 18, 2026 that may be closed by this pull request
@coderabbitai

coderabbitai Bot commented Jun 18, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Too many files!

This PR contains 193 files, which is 43 over the limit of 150.

To get a review, narrow the scope:
• coderabbit review --type committed # exclude uncommitted changes
• coderabbit review --dir # limit to a subdirectory
• coderabbit review --base # compare against a closer base

Upgrade to a paid plan to raise the limit.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: aabe4492-8efe-416e-a46d-9dfd65ded8c2

📥 Commits

Reviewing files that changed from the base of the PR and between 6bc57ab and 9496a29.

⛔ Files ignored due to path filters (3)
  • packages/site/src/content/docs/introduction/encryption-options.png is excluded by !**/*.png
  • packages/site/src/content/docs/introduction/vault-creation.png is excluded by !**/*.png
  • packages/site/src/features/Landing/screenshots/app.png is excluded by !**/*.png
📒 Files selected for processing (193)
  • packages/site/.gitignore
  • packages/site/src/components/analytics/enableTrackKeyboardUsers.ts
  • packages/site/src/components/analytics/index.ts
  • packages/site/src/content/docs/concepts/snapshots.md
  • packages/site/src/content/docs/concepts/vault.md
  • packages/site/src/content/docs/concepts/workspace.md
  • packages/site/src/content/docs/guides/import-export.md
  • packages/site/src/content/docs/guides/organizing-notes.md
  • packages/site/src/content/docs/introduction/index.md
  • packages/site/src/content/docs/introduction/security.md
  • packages/site/src/content/docs/reference/encryption.md
  • packages/site/src/features/Landing/FAQ.tsx
  • packages/site/src/features/Landing/index.tsx
  • packages/site/src/i18n/locales/.transly/downloads.ar.json
  • packages/site/src/i18n/locales/.transly/downloads.bg.json
  • packages/site/src/i18n/locales/.transly/downloads.ca.json
  • packages/site/src/i18n/locales/.transly/downloads.cs.json
  • packages/site/src/i18n/locales/.transly/downloads.da.json
  • packages/site/src/i18n/locales/.transly/downloads.de.json
  • packages/site/src/i18n/locales/.transly/downloads.el.json
  • packages/site/src/i18n/locales/.transly/downloads.es.json
  • packages/site/src/i18n/locales/.transly/downloads.fa.json
  • packages/site/src/i18n/locales/.transly/downloads.fi.json
  • packages/site/src/i18n/locales/.transly/downloads.fr.json
  • packages/site/src/i18n/locales/.transly/downloads.he.json
  • packages/site/src/i18n/locales/.transly/downloads.hi.json
  • packages/site/src/i18n/locales/.transly/downloads.hu.json
  • packages/site/src/i18n/locales/.transly/downloads.id.json
  • packages/site/src/i18n/locales/.transly/downloads.it.json
  • packages/site/src/i18n/locales/.transly/downloads.ja.json
  • packages/site/src/i18n/locales/.transly/downloads.ka.json
  • packages/site/src/i18n/locales/.transly/downloads.ko.json
  • packages/site/src/i18n/locales/.transly/downloads.nb.json
  • packages/site/src/i18n/locales/.transly/downloads.nl.json
  • packages/site/src/i18n/locales/.transly/downloads.pl.json
  • packages/site/src/i18n/locales/.transly/downloads.pt-BR.json
  • packages/site/src/i18n/locales/.transly/downloads.pt-PT.json
  • packages/site/src/i18n/locales/.transly/downloads.ro.json
  • packages/site/src/i18n/locales/.transly/downloads.ru.json
  • packages/site/src/i18n/locales/.transly/downloads.sl.json
  • packages/site/src/i18n/locales/.transly/downloads.sr.json
  • packages/site/src/i18n/locales/.transly/downloads.sv.json
  • packages/site/src/i18n/locales/.transly/downloads.th.json
  • packages/site/src/i18n/locales/.transly/downloads.tr.json
  • packages/site/src/i18n/locales/.transly/downloads.uk.json
  • packages/site/src/i18n/locales/.transly/downloads.vi.json
  • packages/site/src/i18n/locales/.transly/downloads.zh-CN.json
  • packages/site/src/i18n/locales/.transly/downloads.zh-TW.json
  • packages/site/src/i18n/locales/.transly/landing.ar.json
  • packages/site/src/i18n/locales/.transly/landing.bg.json
  • packages/site/src/i18n/locales/.transly/landing.ca.json
  • packages/site/src/i18n/locales/.transly/landing.cs.json
  • packages/site/src/i18n/locales/.transly/landing.da.json
  • packages/site/src/i18n/locales/.transly/landing.de.json
  • packages/site/src/i18n/locales/.transly/landing.el.json
  • packages/site/src/i18n/locales/.transly/landing.es.json
  • packages/site/src/i18n/locales/.transly/landing.fa.json
  • packages/site/src/i18n/locales/.transly/landing.fi.json
  • packages/site/src/i18n/locales/.transly/landing.fr.json
  • packages/site/src/i18n/locales/.transly/landing.he.json
  • packages/site/src/i18n/locales/.transly/landing.hi.json
  • packages/site/src/i18n/locales/.transly/landing.hu.json
  • packages/site/src/i18n/locales/.transly/landing.id.json
  • packages/site/src/i18n/locales/.transly/landing.it.json
  • packages/site/src/i18n/locales/.transly/landing.ja.json
  • packages/site/src/i18n/locales/.transly/landing.ka.json
  • packages/site/src/i18n/locales/.transly/landing.ko.json
  • packages/site/src/i18n/locales/.transly/landing.nb.json
  • packages/site/src/i18n/locales/.transly/landing.nl.json
  • packages/site/src/i18n/locales/.transly/landing.pl.json
  • packages/site/src/i18n/locales/.transly/landing.pt-BR.json
  • packages/site/src/i18n/locales/.transly/landing.pt-PT.json
  • packages/site/src/i18n/locales/.transly/landing.ro.json
  • packages/site/src/i18n/locales/.transly/landing.ru.json
  • packages/site/src/i18n/locales/.transly/landing.sl.json
  • packages/site/src/i18n/locales/.transly/landing.sr.json
  • packages/site/src/i18n/locales/.transly/landing.sv.json
  • packages/site/src/i18n/locales/.transly/landing.th.json
  • packages/site/src/i18n/locales/.transly/landing.tr.json
  • packages/site/src/i18n/locales/.transly/landing.uk.json
  • packages/site/src/i18n/locales/.transly/landing.vi.json
  • packages/site/src/i18n/locales/.transly/landing.zh-CN.json
  • packages/site/src/i18n/locales/.transly/landing.zh-TW.json
  • packages/site/src/i18n/locales/.transly/layout.ar.json
  • packages/site/src/i18n/locales/.transly/layout.bg.json
  • packages/site/src/i18n/locales/.transly/layout.ca.json
  • packages/site/src/i18n/locales/.transly/layout.cs.json
  • packages/site/src/i18n/locales/.transly/layout.da.json
  • packages/site/src/i18n/locales/.transly/layout.de.json
  • packages/site/src/i18n/locales/.transly/layout.el.json
  • packages/site/src/i18n/locales/.transly/layout.es.json
  • packages/site/src/i18n/locales/.transly/layout.fa.json
  • packages/site/src/i18n/locales/.transly/layout.fi.json
  • packages/site/src/i18n/locales/.transly/layout.fr.json
  • packages/site/src/i18n/locales/.transly/layout.he.json
  • packages/site/src/i18n/locales/.transly/layout.hi.json
  • packages/site/src/i18n/locales/.transly/layout.hu.json
  • packages/site/src/i18n/locales/.transly/layout.id.json
  • packages/site/src/i18n/locales/.transly/layout.it.json
  • packages/site/src/i18n/locales/.transly/layout.ja.json
  • packages/site/src/i18n/locales/.transly/layout.ka.json
  • packages/site/src/i18n/locales/.transly/layout.ko.json
  • packages/site/src/i18n/locales/.transly/layout.nb.json
  • packages/site/src/i18n/locales/.transly/layout.nl.json
  • packages/site/src/i18n/locales/.transly/layout.pl.json
  • packages/site/src/i18n/locales/.transly/layout.pt-BR.json
  • packages/site/src/i18n/locales/.transly/layout.pt-PT.json
  • packages/site/src/i18n/locales/.transly/layout.ro.json
  • packages/site/src/i18n/locales/.transly/layout.ru.json
  • packages/site/src/i18n/locales/.transly/layout.sl.json
  • packages/site/src/i18n/locales/.transly/layout.sr.json
  • packages/site/src/i18n/locales/.transly/layout.sv.json
  • packages/site/src/i18n/locales/.transly/layout.th.json
  • packages/site/src/i18n/locales/.transly/layout.tr.json
  • packages/site/src/i18n/locales/.transly/layout.uk.json
  • packages/site/src/i18n/locales/.transly/layout.vi.json
  • packages/site/src/i18n/locales/.transly/layout.zh-CN.json
  • packages/site/src/i18n/locales/.transly/layout.zh-TW.json
  • packages/site/src/i18n/locales/ar/faq.json
  • packages/site/src/i18n/locales/ar/landing.json
  • packages/site/src/i18n/locales/bg/faq.json
  • packages/site/src/i18n/locales/bg/landing.json
  • packages/site/src/i18n/locales/ca/faq.json
  • packages/site/src/i18n/locales/ca/landing.json
  • packages/site/src/i18n/locales/cs/faq.json
  • packages/site/src/i18n/locales/cs/landing.json
  • packages/site/src/i18n/locales/da/faq.json
  • packages/site/src/i18n/locales/da/landing.json
  • packages/site/src/i18n/locales/de/faq.json
  • packages/site/src/i18n/locales/de/landing.json
  • packages/site/src/i18n/locales/el/faq.json
  • packages/site/src/i18n/locales/el/landing.json
  • packages/site/src/i18n/locales/en/faq.json
  • packages/site/src/i18n/locales/en/landing.json
  • packages/site/src/i18n/locales/es/faq.json
  • packages/site/src/i18n/locales/es/landing.json
  • packages/site/src/i18n/locales/fa/faq.json
  • packages/site/src/i18n/locales/fa/landing.json
  • packages/site/src/i18n/locales/fi/faq.json
  • packages/site/src/i18n/locales/fi/landing.json
  • packages/site/src/i18n/locales/fr/faq.json
  • packages/site/src/i18n/locales/fr/landing.json
  • packages/site/src/i18n/locales/he/faq.json
  • packages/site/src/i18n/locales/he/landing.json
  • packages/site/src/i18n/locales/hi/faq.json
  • packages/site/src/i18n/locales/hi/landing.json
  • packages/site/src/i18n/locales/hu/faq.json
  • packages/site/src/i18n/locales/hu/landing.json
  • packages/site/src/i18n/locales/id/faq.json
  • packages/site/src/i18n/locales/id/landing.json
  • packages/site/src/i18n/locales/it/faq.json
  • packages/site/src/i18n/locales/it/landing.json
  • packages/site/src/i18n/locales/ja/faq.json
  • packages/site/src/i18n/locales/ja/landing.json
  • packages/site/src/i18n/locales/ka/faq.json
  • packages/site/src/i18n/locales/ka/landing.json
  • packages/site/src/i18n/locales/ko/faq.json
  • packages/site/src/i18n/locales/ko/landing.json
  • packages/site/src/i18n/locales/nb/faq.json
  • packages/site/src/i18n/locales/nb/landing.json
  • packages/site/src/i18n/locales/nl/faq.json
  • packages/site/src/i18n/locales/nl/landing.json
  • packages/site/src/i18n/locales/pl/faq.json
  • packages/site/src/i18n/locales/pl/landing.json
  • packages/site/src/i18n/locales/pt-BR/faq.json
  • packages/site/src/i18n/locales/pt-BR/landing.json
  • packages/site/src/i18n/locales/pt-PT/faq.json
  • packages/site/src/i18n/locales/pt-PT/landing.json
  • packages/site/src/i18n/locales/ro/faq.json
  • packages/site/src/i18n/locales/ro/landing.json
  • packages/site/src/i18n/locales/ru/faq.json
  • packages/site/src/i18n/locales/ru/landing.json
  • packages/site/src/i18n/locales/sl/faq.json
  • packages/site/src/i18n/locales/sl/landing.json
  • packages/site/src/i18n/locales/sr/faq.json
  • packages/site/src/i18n/locales/sr/landing.json
  • packages/site/src/i18n/locales/sv/faq.json
  • packages/site/src/i18n/locales/sv/landing.json
  • packages/site/src/i18n/locales/th/faq.json
  • packages/site/src/i18n/locales/th/landing.json
  • packages/site/src/i18n/locales/tr/faq.json
  • packages/site/src/i18n/locales/tr/landing.json
  • packages/site/src/i18n/locales/uk/faq.json
  • packages/site/src/i18n/locales/uk/landing.json
  • packages/site/src/i18n/locales/vi/faq.json
  • packages/site/src/i18n/locales/vi/landing.json
  • packages/site/src/i18n/locales/zh-CN/faq.json
  • packages/site/src/i18n/locales/zh-CN/landing.json
  • packages/site/src/i18n/locales/zh-TW/faq.json
  • packages/site/src/i18n/locales/zh-TW/landing.json
  • packages/site/src/pages/[lang]/index.astro
  • packages/site/src/theme/index.ts
  • words.txt

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

The site theme extends with accent and sand color token groups and updated semantic tokens; hardcoded color values in Link.tsx and MarkdownContent.astro are replaced with those tokens. A codeBlock slot recipe with selection styling is added. The Download page gains a Separator element, and getReleases normalizes tag names by stripping a leading v. The documentation structure is reorganized with a sidebar configuration that explicitly lists concept pages and auto-generates guides and reference sections. Four new documentation pages are added covering core concepts (vault, workspace, snapshots) and user guides (import/export, organizing notes). Documentation URLs in the README and VaultCreator are updated to point to the new reference paths. The note editor removes the archive button and sidebar styling is refined; note opening is refactored to use preview mode via useNoteActions instead of direct opening. Input theme styling for the subtle variant is adjusted, and i18n language discovery is broadened to exclude any dot-prefixed locale subdirectory.

Changes

Site Theme and Component Styling

Layer / File(s) Summary
Theme color tokens and codeBlock slot recipe
packages/site/src/theme/index.ts
Adds defineSlotRecipe and codeBlockAnatomy imports; introduces accent and sand base color token groups; reshapes semantic tokens for brand, bg, border, link, and focus ring; adds slotRecipes.codeBlock for text selection styling; updates global ::selection background.
Migrate Link and MarkdownContent to theme tokens
packages/site/src/components/Link.tsx, packages/site/src/components/MarkdownContent.astro
Replaces hardcoded color values in linkRecipe nav, button-primary, and button-secondary variants with accent.*, sand.*, and typography.* tokens; replaces hardcoded img border and blockquote background in CSS with --chakra-colors-border-contrast and --chakra-colors-bg-panel.
Download page Separator and release name normalization
packages/site/src/features/Download/index.tsx, packages/site/src/features/releases.ts
Inserts a Separator between the download button area and platform sections; reformats the Homebrew SimpleCodeBlock code prop as a multi-line string; getReleases now strips a leading v from tag_name via ^v?(.+) regex when computing name.

Documentation Structure and Content

Layer / File(s) Summary
Sidebar configuration and documentation hierarchy
packages/site/astro.config.mjs
Updates sidebar entries for "Concepts", "Guides", and "Reference"; explicitly lists concepts/vault, concepts/workspace, and concepts/snapshots under Concepts; configures Guides and Reference to auto-generate from their respective directories.
Concept documentation pages
packages/site/src/content/docs/concepts/vault.md, packages/site/src/content/docs/concepts/workspace.md, packages/site/src/content/docs/concepts/snapshots.md
Introduces "Vault" documentation covering top-level containers, directory mapping, vault modes (encrypted/unencrypted), encryption behavior, automatic opening, and vault switching; "Workspace" documentation describing isolation and data scoping within a vault; "Snapshots" documentation explaining note revision history, restore semantics, and history control options.
User guide documentation
packages/site/src/content/docs/guides/import-export.md, packages/site/src/content/docs/guides/organizing-notes.md
Introduces "Import & Export" guide covering import from files/archives/directories, file attachment handling, metadata usage, and export of single notes or entire workspaces; "Organizing Notes" guide documenting note lifecycle including creation, tagging (multiple/nested), pinning, starring, archiving, bin/trash, and permanent deletion with retention policies.
Update documentation URLs and introduction content
README.md, packages/app/src/features/App/VaultCreator/index.tsx, packages/site/src/content/docs/introduction/index.md, packages/site/src/content/docs/introduction/security.md
Updates hyperlinks from /introduction/encryption/ to /reference/encryption/; removes the workspace content screenshot from the introduction; replaces the security introduction image with encryption-related content.

App UI and Feature Updates

Layer / File(s) Summary
Input subtle variant focus styling
packages/app/src/components/theme/base.ts
In the input recipe's subtle variant, changes the non-focused selector from :not(:focus-visible) to :not(:focus) and updates the _focus state to set borderColor to transparent.
NoteEditor styling and archive button removal
packages/app/src/features/NoteEditor/NoteSidebar.tsx, packages/app/src/features/NoteEditor/index.tsx
Updates the NoteEditor sidebar header to use padding instead of explicit border styling; adds size="sm" to tabs for smaller sizing; removes the archive toggle button from the note controls toolbar and the FaBoxArchive icon import.
Note opening refactored to preview mode
packages/app/src/hooks/useUrlOpener.ts
Replaces useNotesControl with useNoteActions in useUrlOpener; updates note link handling to invoke clickNote(id, { preview: true }) instead of notesControl.open(id); updates the useCallback dependency array accordingly.

i18n Utilities Improvements

Layer / File(s) Summary
Language discovery and error handling
packages/site/src/i18n/utils.ts
Broadens locale subdirectory exclusion to filter any directory starting with . instead of specifically .transly; adds try/catch in i18nGetContext to log failing language codes and rethrow errors.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐇 The burrow of docs now has structure so bright,
With vaults, workspaces, snapshots—organized just right!
Theme tokens replace the old hardcoded hues,
Archive buttons vanish, preview modes choose,
From import to organizing, each path is clear—
A well-designed app makes this rabbit cheer! 🎨📚

Possibly related PRs

  • DeepinkApp/deepink#243: The main PR's release tag name normalization (stripping v prefix) directly affects the release payload consumed by the app's AppUpdatesChecker.
  • DeepinkApp/deepink#304: The main PR's refactoring of note opening to use useNoteActions.click(..., { preview: true }) aligns with the retrieved PR's temporary/preview tab API changes supporting preview mode.
  • DeepinkApp/deepink#307: Both PRs touch the Chakra theme setup in packages/app/src/components/theme/base.ts, adjusting the input recipe styling (Chakra v3 migration in #307 and subtle variant focus styling in the main PR).
🚥 Pre-merge checks | ✅ 1 | ❌ 4

❌ Failed checks (2 warnings, 2 inconclusive)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning Multiple changes appear to extend beyond typical 'minor site improvements': removal of exported hook useNotesControl, changes to app input styling, archive button removal, and significant theme restructuring suggest broader refactoring than implied by the PR title. Clarify scope boundaries: determine whether feature removal (archive button), hook deprecation, and theme restructuring are intentional scope or should be addressed separately. Update PR title to reflect actual scope.
Docstring Coverage ⚠️ Warning Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check ❓ Inconclusive The title 'docs: minor site improvements' is vague and overly broad. While the PR does include documentation changes, the changeset encompasses far more than just docs: UI refinements, component changes, feature removals, configuration updates, and API modifications across multiple packages. Consider a more specific title that reflects the primary changes, such as 'feat: refactor theme tokens and update documentation structure' or 'refactor: modernize component styling and site content'
Linked Issues check ❓ Inconclusive Linked issue #325 provides no specific coding requirements or objectives to validate. The PR commits and changes align with stated goals of 'minor site improvements' and 'UI/UX refinements', but without detailed requirements in the issue, full validation is impossible. Provide specific requirements or acceptance criteria in issue #325 to enable comprehensive validation of the pull request against the linked issue.
✅ Passed checks (1 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 325-minor-site-improvements

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions

Copy link
Copy Markdown

Cloudflare Pages Deployment

Event Name: pull_request
Environment: preview
Project: deepink
Built with commit: bf44e0d
Preview URL: https://6776c1e5.deepink.pages.dev
Branch Preview URL: https://325-minor-site-improvements.deepink.pages.dev

Wrangler Output

⛅️ wrangler 4.100.0
────────────────────
Uploading... (109/201)
Uploading... (139/201)
Uploading... (170/201)
Uploading... (201/201)
✨ Success! Uploaded 92 files (109 already uploaded) (4.49 sec)

🌎 Deploying...
✨ Deployment complete! Take a peek over at https://6776c1e5.deepink.pages.dev
✨ Deployment alias URL: https://325-minor-site-improvements.deepink.pages.dev

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (2)
packages/site/src/theme/index.ts (2)

145-157: ⚡ Quick win

Replace hardcoded colors with token references for consistency.

The codeBlock slot recipe uses hardcoded hex colors (#f1eae0, #191919) instead of the newly defined design tokens. This is inconsistent with the PR's goal of migrating to design tokens.

♻️ Refactor to use design tokens
 		slotRecipes: {
 			codeBlock: defineSlotRecipe({
 				slots: codeBlockAnatomy.keys(),
 				base: {
 					code: {
 						'& ::selection': {
-							bg: '`#f1eae0`',
-							color: '`#191919`',
+							bg: 'sand.200',
+							color: 'typography.base',
 						},
 					},
 				},
 			}),
 		},
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/site/src/theme/index.ts` around lines 145 - 157, The codeBlock slot
recipe in the slotRecipes object uses hardcoded hex color values for the
selection styling instead of design tokens. Replace the hardcoded colors in the
base.code['& ::selection'] block within the defineSlotRecipe call: replace the
bg value '`#f1eae0`' with the appropriate background design token reference and
the color value '`#191919`' with the appropriate text color design token reference
to maintain consistency with the design token migration.

163-165: ⚡ Quick win

Replace hardcoded color with token reference for consistency.

The global ::selection background uses a hardcoded hex color instead of a token reference. Line 167 demonstrates that token references work in globalCss (e.g., bg: 'bg.canvas'), so this should follow the same pattern.

♻️ Refactor to use design tokens
 		'::selection': {
-			bg: '`#f1eae0`',
+			bg: 'sand.200',
 		},
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/site/src/theme/index.ts` around lines 163 - 165, In the
`::selection` pseudo-element styling block, replace the hardcoded hex color
value `#f1eae0` assigned to the `bg` property with an appropriate design token
reference (similar to how `bg: 'bg.canvas'` is used elsewhere in the globalCss
configuration). Identify the correct token from your design system that
represents this selection background color and use the token reference instead
of the hardcoded color value.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/site/src/features/Download/index.tsx`:
- Around line 235-239: Update the code string passed to the SimpleCodeBlock
component to include the correct Homebrew command sequence. The string should
include three commands in this exact order: first brew tap deepinkapp/tap, then
brew trust deepinkapp/tap, and finally brew install deepinkapp/tap/deepink.
Ensure the commands are properly separated by newline characters (\n) to
maintain the multi-line format. The missing brew tap command must be added and
the trust command must be repositioned to execute before the install command.

---

Nitpick comments:
In `@packages/site/src/theme/index.ts`:
- Around line 145-157: The codeBlock slot recipe in the slotRecipes object uses
hardcoded hex color values for the selection styling instead of design tokens.
Replace the hardcoded colors in the base.code['& ::selection'] block within the
defineSlotRecipe call: replace the bg value '`#f1eae0`' with the appropriate
background design token reference and the color value '`#191919`' with the
appropriate text color design token reference to maintain consistency with the
design token migration.
- Around line 163-165: In the `::selection` pseudo-element styling block,
replace the hardcoded hex color value `#f1eae0` assigned to the `bg` property
with an appropriate design token reference (similar to how `bg: 'bg.canvas'` is
used elsewhere in the globalCss configuration). Identify the correct token from
your design system that represents this selection background color and use the
token reference instead of the hardcoded color value.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5a696c38-89a5-425e-91fd-5d9cf741413a

📥 Commits

Reviewing files that changed from the base of the PR and between c5741b9 and b37d6fb.

📒 Files selected for processing (5)
  • packages/site/src/components/Link.tsx
  • packages/site/src/components/MarkdownContent.astro
  • packages/site/src/features/Download/index.tsx
  • packages/site/src/features/releases.ts
  • packages/site/src/theme/index.ts

Comment thread packages/site/src/features/Download/index.tsx
@github-actions

Copy link
Copy Markdown

Cloudflare Pages Deployment

Event Name: pull_request
Environment: preview
Project: deepink
Built with commit: 7c6ea44
Preview URL: https://3466e9c9.deepink.pages.dev
Branch Preview URL: https://325-minor-site-improvements.deepink.pages.dev

Wrangler Output

⛅️ wrangler 4.100.0
────────────────────
Uploading... (193/211)
Uploading... (199/211)
Uploading... (205/211)
Uploading... (211/211)
✨ Success! Uploaded 18 files (193 already uploaded) (1.74 sec)

🌎 Deploying...
✨ Deployment complete! Take a peek over at https://3466e9c9.deepink.pages.dev
✨ Deployment alias URL: https://325-minor-site-improvements.deepink.pages.dev

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/site/src/content/docs/guides/import-export.md`:
- Around line 25-37: Fix two grammatical errors in the Export section of the
import-export.md file. First, change the sentence "You can export as single note
as whole workspace." to "You can export a single note or a whole workspace." to
correct the preposition and add proper article usage. Second, fix the
subject-verb agreement error in "This way let you export all notes" by changing
it to either "This way lets you export all notes" or restructuring it as "This
way allows you to export all notes" for better clarity.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 46131887-bc77-45e7-a04b-e088788e6524

📥 Commits

Reviewing files that changed from the base of the PR and between b37d6fb and a4bf2ad.

📒 Files selected for processing (9)
  • README.md
  • packages/app/src/features/App/VaultCreator/index.tsx
  • packages/site/astro.config.mjs
  • packages/site/src/content/docs/concepts/snapshots.md
  • packages/site/src/content/docs/concepts/vault.md
  • packages/site/src/content/docs/concepts/workspace.md
  • packages/site/src/content/docs/guides/import-export.md
  • packages/site/src/content/docs/guides/organizing-notes.md
  • packages/site/src/content/docs/reference/encryption.md
✅ Files skipped from review due to trivial changes (6)
  • packages/site/src/content/docs/concepts/snapshots.md
  • packages/app/src/features/App/VaultCreator/index.tsx
  • packages/site/src/content/docs/concepts/vault.md
  • README.md
  • packages/site/src/content/docs/concepts/workspace.md
  • packages/site/src/content/docs/guides/organizing-notes.md

Comment thread packages/site/src/content/docs/guides/import-export.md Outdated
@github-actions

Copy link
Copy Markdown

Cloudflare Pages Deployment

Event Name: pull_request
Environment: preview
Project: deepink
Built with commit: db6838f
Preview URL: https://47230390.deepink.pages.dev
Branch Preview URL: https://325-minor-site-improvements.deepink.pages.dev

Wrangler Output

⛅️ wrangler 4.100.0
────────────────────
Uploading... (112/213)
Uploading... (146/213)
Uploading... (180/213)
Uploading... (213/213)
✨ Success! Uploaded 101 files (112 already uploaded) (2.95 sec)

🌎 Deploying...
✨ Deployment complete! Take a peek over at https://47230390.deepink.pages.dev
✨ Deployment alias URL: https://325-minor-site-improvements.deepink.pages.dev

@github-actions

Copy link
Copy Markdown

Cloudflare Pages Deployment

Event Name: pull_request
Environment: preview
Project: deepink
Built with commit: a922d3f
Preview URL: https://794b021d.deepink.pages.dev
Branch Preview URL: https://325-minor-site-improvements.deepink.pages.dev

Wrangler Output

⛅️ wrangler 4.100.0
────────────────────
Uploading... (113/213)
Uploading... (146/213)
Uploading... (180/213)
Uploading... (213/213)
✨ Success! Uploaded 100 files (113 already uploaded) (2.57 sec)

🌎 Deploying...
✨ Deployment complete! Take a peek over at https://794b021d.deepink.pages.dev
✨ Deployment alias URL: https://325-minor-site-improvements.deepink.pages.dev

@github-actions

Copy link
Copy Markdown

Cloudflare Pages Deployment

Event Name: pull_request
Environment: preview
Project: deepink
Built with commit: f5651c3
Preview URL: https://5b554482.deepink.pages.dev
Branch Preview URL: https://325-minor-site-improvements.deepink.pages.dev

Wrangler Output

⛅️ wrangler 4.100.0
────────────────────
Uploading... (194/213)
Uploading... (200/213)
Uploading... (206/213)
Uploading... (213/213)
✨ Success! Uploaded 19 files (194 already uploaded) (1.63 sec)

🌎 Deploying...
✨ Deployment complete! Take a peek over at https://5b554482.deepink.pages.dev
✨ Deployment alias URL: https://325-minor-site-improvements.deepink.pages.dev

@github-actions

Copy link
Copy Markdown

Cloudflare Pages Deployment

Event Name: pull_request
Environment: preview
Project: deepink
Built with commit: 2c30433
Preview URL: https://3695e778.deepink.pages.dev
Branch Preview URL: https://325-minor-site-improvements.deepink.pages.dev

Wrangler Output

⛅️ wrangler 4.100.0
────────────────────
Uploading... (112/213)
Uploading... (145/213)
Uploading... (179/213)
Uploading... (213/213)
✨ Success! Uploaded 101 files (112 already uploaded) (2.61 sec)

🌎 Deploying...
✨ Deployment complete! Take a peek over at https://3695e778.deepink.pages.dev
✨ Deployment alias URL: https://325-minor-site-improvements.deepink.pages.dev

@vitonsky
vitonsky merged commit b41a603 into master Jun 20, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Minor site improvements

1 participant