Bases Visuals

by Gabriel Bacha
5
4
3
2
1
Score: 48/100

Description

Notion-inspired pill colors and conditional formatting for Obsidian Bases

Reviews

No reviews yet.

Stats

1
stars
4,450
downloads
0
forks
102
days
5
days
5
days
2
total PRs
0
open PRs
0
closed PRs
2
merged PRs
5
total issues
1
open issues
4
closed issues
53
commits

Latest Version

6 days ago

Changelog

Plugin page and more tools: Mindful Apps

Changelog

All notable changes to Bases Visuals are documented here.

0.20.2 — 2026-11-14

  • Changes always go to the right Base. A colour or rule change that was saved after a short delay could reach another Base when you switched notes or panes before the save. The save now stays with the file and view where you made the change.
  • The plugin reads a Base file again when a pane opens another Base. Before, it could use cached settings from the Base that the pane showed before.
  • Plugin links now go to Mindful Apps.

0.20.1 — 2026-11-05

  • No more freezes with embedded Bases. Finding the table a cell belongs to could search every open note's internals for each cell and column, and a failed search was never remembered. With a Base embedded in a note, this blocked Obsidian for 10–50 seconds on a tab switch. A table found once is now matched by its element, only the note that holds the cell is searched, and a failed search is remembered until the layout changes. Class changes outside a Base no longer trigger any work. (#2)
  • Row rules hold when their column is scrolled out of view. A Base renders only the columns in view, so a row rule lost its colour as soon as the column it tests scrolled away. The value now comes from the row's note in the Base's results (found through its name column, or by position when every row is shown), or failing that from what the row last showed. (#5)
  • Empty cells stay empty in formatted rows and cells. A rule's text colour also coloured the hidden placeholder of an empty cell, so “No value” appeared once the rule matched. (#4)

0.20.0 — 2026-10-04

  • Select columns declared in the Base's own properties block show as pills. Options written there as a map (done: green) or as a list ([low, { value: high, color: orange }]) now give select cells, list pills and group headings their colour. Before, only options in basesStudio were read, so these columns showed plain text and their groups took a strategy colour. A colour set on a value in the plugin still wins. Nothing is written back to the file.
  • Select pills are as wide as their text, not the whole cell, and a column's custom or muted text colour no longer paints over the pill's own text colour.
  • URLs inside text cells open on a click or a tap. A text value such as see https://example.com showed the address as plain text, and a click on it started editing. Each URL is now underlined in the link colour and opens in the browser; a click or tap on the rest of the text still edits it, and the text is never changed. On touch screens, a tap on a URL does not open the keyboard.

0.19.0 — 2026-09-29

  • Large grouped tables no longer lag. A change in one cell restyled the whole table, so a render that touched every cell took time that grew with the square of the rows (100 rows: about 14 s in tests, now under 0.1 s). A value or property seen for the first time no longer restyles the table either, since it changes no colour.
  • A click on a file name opens the note again; a click on the empty part of the cell renames it. Obsidian shows the name as a span.internal-link, which the plugin did not treat as a link. The main column's link style now applies to it too.
  • The toolbar buttons can no longer be moved without end when the toolbar has no Sort button.
  • Status marks (@gabrielbacha/bases-contract 2.1.0). A select option that BaseStudio gives a workflow category (todo, active, done) shows the same mark as in BaseStudio: a dashed circle, a dotted circle or a check, on its pills and group headings. Filters never use the category.

0.18.0 — 2026-09-28

  • One block for everything both apps add to a Base: basesStudio (@gabrielbacha/bases-contract 2.0.0). At the root it holds the palette, each property's record (type, options with their colours, pill strategy, column style, default value), the Base rules, detail layouts and toolbar settings. Inside each view it holds that view's settings, its columns' wrap and style, and its rules.
  • Bases saved by older releases (basesVisuals, basesVisualsView, basesVisualsColumnAppearance, basesVisualsBase, and BaseStudio's basesEditor and basesEditorView) are read as before. Opening a Base never changes it; the first intentional edit moves the whole file into basesStudio and removes the old blocks. Older releases of the plugin do not read basesStudio: update the plugin on every device.
  • A value has one colour, stored on its option (color: a palette preset, a hex, or none), whether BaseStudio declares the option or not. The separate declared-colour path is gone.
  • Share one contract with BaseStudio: YAML patching, rule matching, colours, strategies, the block merge, names and row heights are no longer kept as a separate copy in the plugin.
  • A rule's background opacity means the same in both apps: 0–100, where a missing value means 100. Older blocks keep the tint they showed (12%, or 3% for Muted); the move into basesStudio writes it explicitly. Rules no longer store scope: the block they are in gives it.
  • Single-value select columns declared by BaseStudio show as pills in Obsidian, with their option labels.
  • Edits made to an open Base in another app are picked up without reopening it.
  • Inline rename repairs the typed name the way BaseStudio does, and numbers a name already used (“Existing 2”), in place of refusing it.
  • A block saved by a newer version is read but never rewritten.
  • Column style is read by the shared contract, so BaseStudio shows the same tones, colours, bold and alignment (Auto, Left, Center, Right). A custom colour is adjusted per theme so it stays readable in dark mode, and the rule colours are offered as one-click swatches.

0.17.0 — 2026-09-22

  • Preserve unknown basesVisuals and basesVisualsView fields, nested fields, malformed entries, and newer schema versions when saving recognized settings.
  • Rebase compatible writes onto the latest .base contents and report same-setting conflicts instead of overwriting another editor's changes.
  • Stop pruning configuration merely because a property is temporarily absent; cleanup remains an explicit, confirmed action.
  • Show Obsidian notices when .base persistence fails instead of silently continuing with only in-memory state.
  • Patch YAML/JSON extension records through source ranges so comments, quoted keys, formatting, and unrelated Base data survive saves.
  • Store view-scoped column appearance in basesVisualsView schema 2 and migrate the legacy view key only after an intentional edit.
  • Merge concurrent changes at field granularity, detect duplicate rule identities, and keep future option and strategy variants opaque.
  • Keep opening and hydrating a Base read-only; alias normalization and legacy migration become durable only with a user edit.

0.16.0 — 2026-09-16

  • Add direct in-cell filename editing to Base table rows without interfering with the filename link.
  • Preserve the file's folder and extension, reject invalid or duplicate names, and report failures through Obsidian notices.
  • Resolve each row through its native Bases entry so renaming remains reliable in grouped and virtualized tables.

0.15.0 — 2026-09-15

  • Add an accessible + button to writable list-property group headings.
  • Open Obsidian's native new-note prompt with the clicked group value already assigned while preserving Base creation defaults.
  • Add a per-property Wrap pills option for flowing long list values onto additional lines.
  • Make new column-appearance changes Base-wide by default while preserving explicit view overrides.
  • Require Obsidian 1.10.2 for the supported Bases file-creation API.

0.14.0 — 2026-09-02

  • Store Base-wide visual choices once in a sparse, portable top-level basesVisuals block instead of copying a complete registry into every view.
  • Keep automatically discovered properties and values in memory so opening or scrolling a Base no longer grows its file.
  • Migrate legacy basesVisualsBase blocks while discarding default-only values and settings unrelated to the current Base.
  • Scope Clean unused to the current Base result set instead of treating values elsewhere in the vault as locally used.

0.13.2 — 2026-08-31

  • Add collapsible property categories to the Pill colors manager with clear chevrons and keyboard-accessible title controls.
  • Save collapsed categories by canonical property ID across manager and Obsidian reloads while temporarily expanding search results.
  • Prevent theme button hover and focus styles from turning disclosure headers into oversized gray controls.

0.13.1 — 2026-08-31

  • Rework conditional-formatting treatments so long actions no longer overlap or clip.
  • Give Override pill colors a dedicated full-width setting row with supporting text.
  • Truncate long color summaries cleanly and remove intrusive field-group tooltips.
  • Allocate more room to formatting controls while retaining the responsive stacked layout.

0.13.0 — 2026-08-31

  • Make new conditional-formatting rules visually empty until a treatment is selected.
  • Add a true No background action and rename the conditional neutral treatment to Muted.
  • Replace browser datalist value completion with Obsidian's native suggestion menu.
  • Restore direct keyboard editing, selection, copying, and pasting in custom hex inputs.
  • Add an optional Override pill colors treatment for conditional backgrounds.

0.12.0 — 2026-08-31

  • Redesign conditional-formatting cards into a responsive When/Then layout without horizontal scrolling.
  • Restrict conditional-formatting properties to the current Base and add native value autocomplete.
  • Add independent background and exact text colors, including a permanent light Neutral treatment.
  • Add optional Bold and Strikethrough text treatments to formatting rules.
  • Add per-rule background tint strength from 0–100%, with synchronized controls and a stronger hover state.
  • Keep pill appearance changes responsive and persistent across live views and rerendered Base configuration objects.
  • Improve compact pill-style and color-strategy controls throughout the full manager and column popovers.
  • Preserve backward compatibility by safely discarding the unsupported conditional row-height experiment from saved rules.

0.11.0 — 2026-08-31

  • Convert Pill style and Color strategy settings into space-efficient live preview dropdown triggers.
  • Support continuous live previewing with dropdowns remaining open during option selection.
  • Reduce pill preview rounding to 4px to match Obsidian's native multi-select pill styling.
  • Streamline Color strategy choices to Smart, Distinct values, Single color, Neutral, and Off.
  • Remove redundant single-color swatch palette from Smart mode so automatic heuristics apply cleanly.
  • Fix dropdown menu overflow clipping in popovers and modals with fixed body-mounted positioning and auto-flip collision handling.
  • Fix right-click column context menu popover interaction and live updates.
  • Keep the Reset property button permanently visible in the format manager to eliminate layout shifts.
  • Fix column bolding in tables where some rows contain empty cells.

0.10.1 — 2026-08-31

  • Preserve Solid and Outline pill styles when they are attached to the default Smart color strategy.
  • Merge Base-wide visual changes from separate live views instead of letting stale complete records overwrite one another.
  • Propagate merged pill settings immediately across every open view of the same .base file.
  • Serialize .base synchronization so an older save cannot finish after and undo a newer change.
  • Preserve local edits made while sibling Base settings and canonical property identities are still hydrating.
  • Add regression coverage for simultaneous note.priority_todo and note.workstream_todo style changes.

0.10.0 — 2026-08-30

  • Add complete arrow, Home, and End keyboard behavior with roving focus to custom row-height, width-scope, and column-tone radio groups.
  • Centralize native pill removal for the hover ×, Delete/Backspace, and the right-click manager.
  • Prevent active-pill deletion from falling through to Obsidian's cell-level delete behavior when native removal is unavailable.
  • Detect unavailable or non-responsive native pill controls and show a throttled compatibility notice instead of failing silently.
  • Batch and deduplicate Base DOM mutations with one discovery traversal per changed subtree, including virtualized table updates.
  • Clean detached leaves from tracked collections instead of rescanning their complete DOM during teardown.
  • Add desktop drag-and-drop ordering for conditional-formatting rules with clear insertion indicators and exact positioning.
  • Preserve Move up/down buttons and Alt+Arrow ordering, and announce successful moves to assistive technology.
  • Disable ambiguous drag ordering while rule search is filtering the visible list.
  • Expand Smart property recognition for suffixed status and priority fields and support more common semantic value aliases.
  • Normalize ordered and parenthetical values such as 2.In Progress, 3.Waiting (for a dependency), and 1.P0 before semantic color matching.

0.8.0 — 2026-08-29

  • Add Soft, Solid, and Outline pill styles per property, independently of its color strategy.
  • Use white text for Solid pills and darken bright accents only as much as needed for readable contrast.
  • Apply pill styles consistently to live tables, previews, contextual managers, and grouped-value badges.
  • Add a confirmed Clean unused action that removes stale saved pill settings without changing notes.
  • Sort numbered values naturally, so 2 appears before 10 and 17.
  • Assign leading-numbered Distinct values predictably across the nine-color palette.
  • Rework grouped-value badges into a flush U shape with square top corners and rounded bottom corners.
  • Normalize native pill spacing to remove inconsistent left padding across property types.
  • Refresh pill styles immediately after settings changes and recover them when Obsidian rewrites rendered classes.

0.7.0 — 2026-08-28

  • Add Smart, Distinct, Status, Priority, Single color, Neutral, and Off strategies for each property.
  • Infer restrained defaults from property IDs and display names while keeping exact value overrides authoritative.
  • Add semantic Status and Priority mappings, including ordered labels such as 1. In Progress and 2. Done.
  • Replace the legacy palette with nine stable named accents and migrate existing preset overrides automatically.
  • Generate WCAG AA pill text colors separately for light and dark themes over softer 12% backgrounds.
  • Add property-strategy controls to the Format manager and the column-focused pill manager.
  • Replace full-width group color banners with neutral headings and accessible colored value badges.
  • Render main-column links neutrally at rest, revealing Obsidian's accent on hover and keyboard focus.
  • Apply the same contrast system to custom colors, previews, group badges, and conditional formatting.
  • Persist explicit property strategies with Base-wide visual data while leaving derived Smart choices unstored.

0.6.0 — 2026-08-14

  • Store pill colors with each Base and share them across that Base's views.
  • Add per-rule This view and All views scopes for conditional formatting.
  • Add an All views in this base toggle for column text color and emphasis.
  • Copy existing global pill colors and rules into each Base on first use, then let Bases evolve independently.
  • Synchronize Base-wide visual settings to newly created views while keeping view-specific rules isolated.
  • Move Base-specific visual management to the native Format toolbar manager.
  • Keep reusable layout presets and manager preferences global.
  • Preserve normal Obsidian behavior when the plugin is disabled by using namespaced Base view configuration.

0.5.0 — 2026-08-14

  • Color grouped table headings with the same property/value color as their matching pills.
  • Remove the native gray gap between colored group headings and their rows.
  • Add a native Column appearance entry to column-header context menus.
  • Add view-specific Default, Muted, Faint, and custom text colors for column body cells.
  • Add an independent Bold column control that combines with every text treatment.
  • Preserve semantic pill colors while gently reducing their prominence in muted or faint columns.
  • Open Column appearance as a hoverable, keyboard-accessible submenu beside the native menu.
  • Keep column headers unchanged when applying body-cell appearance.
  • Display the full author name, Gabriel Bacha, in Obsidian.

0.4.0 — 2026-08-13

  • Add a native Layout toolbar control beside Format for Base tables.
  • Expose Obsidian's Short, Medium, Tall, and Extra tall row-height settings directly in Layout.
  • Add Compact, Standard, Wide, and Maximum column-width presets with Unset only and confirmed All columns scopes.
  • Keep the Layout popover open while testing widths and make its toolbar button toggle the popover closed.
  • Add temporary column-header indicators showing which columns match or will change with the selected width.
  • Add named saved-layout presets that restore row height, column width, and width scope together.
  • Add confirmed column-width reset and confirmation before every operation that overwrites all column widths.
  • Add a subtle Base header tint and bold the first configured visible column.
  • Persist and validate layout presets through settings schema version 3.

0.3.0 — 2026-08-06

  • Add an intent-first pill menu with separate color and column-manager views plus native-backed removal from the current row.
  • Show column search only for larger value sets and highlight the originally clicked value.
  • Refine pill menus with native icons, compact swatches, clearer focus states, and confirmation before removing a value.
  • Make conditional-formatting rule fields horizontally scrollable in narrow manager windows.
  • Match the Base toolbar with a transparent, compact palette + Format control.
  • Add a unified Bases Visuals modal with Pill colors and Conditional formatting tabs.
  • Reuse the searchable, property-grouped pill color manager in both the modal and settings.

0.2.2

  • Match the native two-level Base toolbar item structure.
  • Remove the oversized filled appearance from the Conditional formatting action.

0.2.1

  • Fix the Conditional formatting toolbar button in native Base file views.
  • Match Obsidian's current sibling .bases-header and .bases-view structure.

0.2.0

Initial public release.

  • Add deterministic Notion-inspired colors for list-property pills.
  • Add preset, custom, automatic, and disabled color states.
  • Add conditional formatting for matching cells and entire rows.
  • Add a native-style Conditional formatting action to Base table toolbars.
  • Support native and embedded Base tables, virtualized rows, and pop-out windows.
  • Preserve Obsidian's native list editor without modifying notes or Base definitions.

README file from

Github

Bases Visuals

Bases Visuals adds compact, Notion-inspired pill colors and conditional formatting to Obsidian Base tables.

Features

  • Stable automatic colors scoped by property and value
  • Named presets plus custom hex colors
  • Eight switchable palette templates with full live previews: Default · Bases Visuals plus Sunset spectrum, Desert coast, Editorial, Ocean depth, Ember, Citrus grove, and Electric bloom. Changing a template updates automatic and preset colors per Base while preserving custom colors.
  • A centralized manager for every discovered pill color
  • Searchable settings manager grouped by property
  • Collapsible property categories whose state is remembered across Obsidian reloads
  • Long labels stay compact with ellipsis and a full-value tooltip
  • Native and embedded Base table support
  • Light and dark theme-aware colors
  • Ordered conditional-formatting rules for text, lists, checkboxes, inputs, and numbers
  • Drag, button, and keyboard ordering for conditional-formatting rules
  • Responsive, Base-scoped conditional-formatting cards with value autocomplete
  • Balanced treatment controls with a dedicated pill-override row and clean truncation for long color summaries
  • Independent background and exact text colors, including a permanent light Muted treatment
  • Optional bold and strikethrough conditional formatting
  • Per-rule background tint strength from 0–100%, with a slightly stronger hover state
  • A native-looking palette button in Base table toolbars
  • A compact Layout popover for native row heights and reusable column widths
  • Named layout presets that restore row height, width, and application scope together
  • Temporary header indicators showing which columns match the selected width
  • Subtle table-header tinting and emphasis for the first visible column
  • Grouped row headings that automatically mirror the grouped value's pill color
  • A compact group-heading button that creates a new note with the clicked list value already assigned
  • Inline filename editing from Base tables without opening or context-clicking the note
  • View-specific column appearance with muted, faint, custom-color, and bold treatments
  • Keyboard-accessible layout, width-scope, and column-tone controls
  • Guarded native pill removal that never lets Delete or Backspace clear the whole cell

Usage

Open a Base table containing a list property. Values receive stable automatic colors as they appear.

  • Left-click a cell to keep using Obsidian's native value editor.
  • Hover or focus a pill to reveal its × control. When an individual pill is active, Delete or Backspace removes only that value rather than clearing the cell.
  • Right-click a pill for a compact action menu. Open its palette only when changing color, manage every encountered value in that table column, or remove the clicked value from its row.
  • Click Format in a Base table toolbar to open the Base-scoped manager directly on Pill colors; Conditional formatting remains available in its second tab.
  • Click Layout to adjust row height, test column-width presets, reset widths, or save the current combination as a reusable layout.
  • Use Unset only to preserve unrelated manual widths. Header indicators show which columns will change. All columns always asks for confirmation.
  • Group a table by a colored list property to carry each value's pill color into its group heading. Use the + button beside a group to open Obsidian's new-note prompt with that list value already assigned.
  • In a file.name column, click the empty area of a filename cell to rename that file in place; the filename link itself still opens the note. Press Enter or leave the field to save, or press Escape to cancel. The file stays in its current folder with its original extension, and duplicate or invalid names are rejected safely.
  • Right-click a column header and choose Column appearance to de-emphasize, recolor, or bold that field in the current view or every view in the Base.
  • For list columns, right-click the header and choose Pill appearance to change its color strategy and Soft, Solid, or Outline style without opening the full manager.
  • Enable Wrap pills there to flow multiple list pills onto additional lines within the column.
  • Choose Format in the Base toolbar to manage conditional formatting and every discovered property value for that Base.
  • In Conditional formatting, choose a property from the current Base and start typing to select a value from Obsidian's suggestion menu. New rules start without a visual treatment. Choose an optional Background and its tint percentage, optional Text color, Bold or Strikethrough, and whether that background should override pill colors. Explicit text colors render exactly as selected; leave Text on Automatic when you want accessible contrast against the background.
  • Reorder conditional-formatting rules by dragging their grip, with Move up/down buttons and Alt+Arrow retained for keyboard and mobile use.

Pill colors are scoped to the current Base and shared by its views. Base-wide choices are stored once in a sparse top-level basesVisuals block, while automatic values are discovered in memory and never written. Unknown extension fields and newer schema versions are preserved so another compatible editor can safely share the same block. Concurrent edits to different fields are merged; incompatible edits to the same field are left unsaved and reported instead of being overwritten. Friendly column names are display-only: settings remain attached to the underlying note property even when a Base renames the column. Conditional-formatting rules can target only the current view or every view in the Base, remain case-insensitive, and are evaluated top-to-bottom. Color and conditional-formatting changes never modify existing note properties; the group + action creates a new note with the selected list value. Layout actions use Obsidian's native Base view configuration. Shared appearance lives in basesVisuals; view-only rules and column appearance live in basesVisualsView. Column appearance is shared across every view in the Base by default; turn off All views in this base to create a view-specific override. The explicit Remove from row action delegates that one list edit to Obsidian.

Smart strategies recognize common property families such as status, state, workflow, phase, priority, severity, and suffixed forms such as status_todo or sprint_priority. Ordered labels and explanatory suffixes are normalized, so values such as 2. In Progress, 3.Waiting (for a dependency), and 1.P0 retain their semantic colors.

Installation

Community plugins

Bases Visuals is being prepared for the Obsidian Community Plugins directory. Once accepted, install it from Settings → Community plugins → Browse.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest GitHub release.
  2. Place them in <vault>/.obsidian/plugins/bases-pill-colors/.
  3. Reload Obsidian and enable Bases Visuals under Community plugins.

Privacy and data access

  • Bases Visuals works entirely offline and makes no network requests.
  • It observes rendered Base tables and stores only explicit visual preferences in sparse, namespaced Base configuration.
  • Visual settings do not modify note Markdown or frontmatter. The group + action explicitly creates a new note with the selected list value, inline filename editing renames the selected file through Obsidian, and Remove from row invokes Obsidian's native list-value removal control. Base-wide choices are saved once at the top level of the .base file; view-specific choices remain with that view.
  • It includes no telemetry or analytics.

Development

npm install
npm run dev

Use npm run build, npm test, and npm run lint before releasing.

Support

Report bugs and request features through GitHub Issues.

License

MIT


Filename helper ownership and isolated checks

src/generated/portable-names.ts is a compatibility copy of canonical contract v2 Applications-GB/_Supporting/bases-contract-NPM/src/names.ts. The normal plugin build imports this file for rename behavior; other contract imports retain the registry dependency. Run node scripts/filename-contract.mjs --update after validating a canonical change. The build checks the pinned SHA-256, and checks canonical drift when that checkout is present. A standalone clone can build using its checksum-pinned copy. Do not hand-edit the generated helper.

BPC_BUILD_DIR directs a development bundle to an isolated output folder. The native acceptance test uses the existing strict Obsidian harness with a generated vault/profile, the installed executable and code-only ASAR. It verifies artifact, user-data and vault ownership and closes only its owned processes. The supplemental source-rule layout fixture uses SDK test stubs; the ordinary plugin and real popout are loaded normally. No installed plugin, existing profile or personal vault is changed.

Clean unused checks cached Markdown note properties across the vault, which includes notes hidden by another Base filter. It keeps declared options and uncertain properties, lists the proposed removals and checks their usage again at confirmation. Unindexed notes prevent removal. A failed close-time save keeps its dirty data for retry; it is not silently discarded. The Obsidian void unload hook cannot delay operating-system application exit.

The immutable source files in tests/baseline/ are the performance reference recorded by provenance.json; they are not maintained as a second implementation. Comparisons use named synthetic sizes and the same host. They do not establish a maximum supported table or an absolute response-time target.

Scoped settings capture the Base file and native view when an edit starts. If Obsidian reuses a pane for another file or view, the old store completes its queued write against the original target and a new store reads the new target. Save results belong to their store, so a late result cannot overwrite the new pane's feedback.