Skip to content

Conversation

olaurendeau
Copy link
Contributor

@olaurendeau olaurendeau commented Sep 9, 2025

Purpose

This PR propose to handle the pinned document case raised here by @AntoLC

Screenshot 2025-09-09 at 16 58 21

Proposal

  • Put a pin in the top right corner of the emoji or default icon
  • Also display the pin in the left panel where pinned items are

External contributions

Thank you for your contribution! 🎉

Please ensure the following items are checked before submitting your pull request:

  • I have read and followed the contributing guidelines
  • I have read and agreed to the Code of Conduct
  • I have signed off my commits with git commit --signoff (DCO compliance)
  • I have signed my commits with my SSH or GPG key (git commit -S)
  • My commit messages follow the required format: <gitmoji>(type) title description
  • I have added a changelog entry under ## [Unreleased] section (if noticeable change)
  • I have added corresponding tests for new features or bug fixes (if applicable)

@olaurendeau olaurendeau force-pushed the feat/emoji-pinned branch 3 times, most recently from a666081 to 15c2f1c Compare September 9, 2025 15:16
Adding a new .svg pin image to display in the top right corner
of doc leading emoji or default icon
@AntoLC AntoLC self-requested a review September 10, 2025 07:52
@AntoLC AntoLC added enhancement improve an existing feature frontend labels Sep 10, 2025
@AntoLC AntoLC requested review from rl-83 and virgile-dev September 10, 2025 07:53
@virgile-dev
Copy link
Collaborator

virgile-dev commented Sep 10, 2025

Hey @olaurendeau
Thanks again for this great contribution. My document trees are a lot nicer thanks to you :)
I just had design meeting with @rl-83
I personnaly thought that you could apply emojis to only sub-docs which makes the tree more readable and friendly.
We want to make a couple enhancements on your feature.
First on how you select an emoji for the page. Instead of inserting an emoji the title we'd like for the user to click on the sub-doc icon and choose emoji (type to search emoji).
Then we're not in favor of allowing emojis on the parent document because the document icon is important in the UI for users to recognize the document type especially from apps like Drive.
@rl-83 will propose a design ?
Would you like to help us on making the adjustments ?

@rl-83
Copy link
Collaborator

rl-83 commented Sep 10, 2025

Here is my proposal to update the design

Change summary

  • Add an emoji picker to quickly change a sub-document’s icon.
  • Disable emojis on the parent document and on all top-level (index) documents.

Rationale

  • In a wiki, prefixing some pages with emojis can improve scannability and comprehension.
  • Replacing a top-level document’s default icon with an emoji can obscure its “document” affordance and make users think it’s another object—especially for items surfaced in Drive, where we must clearly indicate they’re text documents.
  • A homepage crowded with emojis becomes visually noisy and can hurt recognition; this only works if emojis are used sparingly (we can’t guarantee that).
  • We can take the time to imagine smarter ways to differentiate documents on the homepage (color, emoji into the page-icon, ...). For now, placing a smaller emoji in the page title seems sufficient.
CleanShot 2025-09-10 at 18 05 25@2x

@virgile-dev
Copy link
Collaborator

Thanks @rl-83 for the updated proposal.
Is your emoji picoler the one from the user’s OS ? could we have a way to search for emojis ? Thanks !

@olaurendeau
Copy link
Contributor Author

olaurendeau commented Sep 11, 2025

Hi @rl-83,
Thanks for this design proposal, what about the page title field, should we still display the emoji in it and allow users to edit the emoji from there ?
Screenshot 2025-09-11 at 09 00 38

@AntoLC
Emoji Picker : Should we simply trigger the OS Emoji picker or add a web one (I see that emoji-mart is already available) ?

Storage : Based on Robin's design we could lean toward separating the emoji & title backend storage, however I would rather try to stick with the current solution (emoji can be the first char of the title) until we land a satisfying UX. WDYT ?

@sampaccoud added a feature request also about this, may should we bring back the discussion in the original issue ?

@rl-83
Copy link
Collaborator

rl-83 commented Sep 11, 2025

Hey @olaurendeau, good idea! It would be also nice to update the emoji in the title by clicking the existing emoji within a button like in the side panel.
My updated proposal
CleanShot 2025-09-11 at 18 49 30@2x

@AntoLC
Copy link
Collaborator

AntoLC commented Sep 11, 2025

@AntoLC Emoji Picker : Should we simply trigger the OS Emoji picker or add a web one (I see that emoji-mart is already available) ?

Storage : Based on Robin's design we could lean toward separating the emoji & title backend storage, however I would rather try to stick with the current solution (emoji can be the first char of the title) until we land a satisfying UX. WDYT ?

@sampaccoud added a feature request also about this, may should we bring back the discussion in the original issue ?

It was a simple dev that is going to be over-engineering for a simple emoji in the title I find..
We can :

  • add a emoji in the title by ourself
  • have a emoji picker in the title if not a top parent
  • have a emoji picker in the tree
  • have a emoji picker trigger from the action menu apparently as well, same if not a top parent

Yes we use "emoji-mart", mainly because Blocknote use it at the base to keep some consistency, but emoji-mart is not well maintain, I have often to debug it.
The icon in the interlink has to be replaced as well, it is here:

<SelectedPageIcon width={11.5} />
<Text $weight="500" spellCheck="false" $size="16px" $display="inline">

olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
@olaurendeau
Copy link
Contributor Author

Hello @virgile-dev @rl-83 & @AntoLC ,
I've developed the proposed solution in this PR #1381 (that is pretty heavy 😬 )
I think we can close this one ?

olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 15, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 16, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 16, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 16, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 16, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 22, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 22, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 22, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 22, 2025
@virgile-dev
Copy link
Collaborator

Thanks @olaurendeau we’ll review your new PR asap !

olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 26, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 26, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 26, 2025
olaurendeau added a commit to olaurendeau/docs that referenced this pull request Sep 26, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement improve an existing feature frontend
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants