Style Definition
Property Type Default Description stylesobject {}Top-level section containing named style definitions. Each key is a style name referenced by formatters or headers. styles.<name>.backgroundColorstring None Background color using a color token name (e.g., grey100, red200) or a predefined style name styles.<name>.colorstring None Text color using a color token name (e.g., grey700, purple700) styles.<name>.fontWeightnumber/string None Font weight value (e.g., 600 for semi-bold) styles.<name>.textDecorationstring None Text decoration (e.g., line-through)
Predefined Styles
Powersheet includes 20 built-in styles available without any custom definition. Custom styles defined in the styles section are merged on top of these defaults.
Status Styles
Style Name Text Color Background Color Other nonenone none boldTitlefontWeight: 600unsupportedgrey800grey200textDecoration: line-throughreadOnlyRead-only cell indicator
Neutral Styles
Style Name Text Color Background Color darkgreygrey700grey200greygrey700grey100
Color Styles
Style Name Text Color Background Color darkredred700red200redred700red100darkorangeorange700orange200orangeorange700orange100darkgreengreen700green200greengreen700green100lightgreengreen700primaryalt100darkblueblue700blue200blueblue700blue100lightblueblue700teal100darktealteal700teal200tealteal700teal100darkpurplepurple700purple200purplepurple700purple100lightpurplepurple700primary100
Style Resolution Flow
Defining Custom Styles
styles :
readOnlyStyle :
backgroundColor : 'grey100'
warningHeader :
backgroundColor : 'orange200'
color : 'orange700'
criticalCell :
backgroundColor : 'red100'
color : 'red700'
fontWeight : 600
Styles are applied to cells via the formatters section. A formatter references a style name and applies it when an expression evaluates to true.
formatters :
readonly :
- expression : 'true'
style : readOnlyStyle
styles :
readOnlyStyle :
backgroundColor : 'grey100'
columns :
outlineNumber :
title : "#"
width : 80
formatter : readonly
isReadOnly : true
Styles are applied to column headers via the header.style property on a column, or to column group headers via groupStyle and headerStyle on a column group.
columns :
description :
title : Foreseeable Sequence of Events
width : 140
header :
style : lightpurple
columnGroups :
epic :
groupName : Epics
groupStyle : darkgreen
headerStyle : green
collapseTo : title
See Column Groups for full group styling reference.
Color Token Reference
Styles use color tokens as shorthand for hex color values. Each color family has variants from 100 (lightest) to 700 (darkest).
Purple
Token Value purple100#eae6ffpurple200#c0b6f2purple300#998dd9purple400#8777d9purple500#6554c0purple600#5243aapurple700#403294
Blue
Token Value blue100#deebffblue200#b3d4ffblue300#4c9affblue400#2684ffblue500#0065ffblue600#0052ccblue700#064198
Teal
Token Value teal100#e6fcffteal200#c1f7ffteal300#79e2f2teal400#00c7e6teal500#00b8d9teal600#00a3bfteal700#006686
Green
Token Value green100#edfae1green200#c9eea4green300#abe86fgreen400#8dce4cgreen500#6aa82bgreen600#3d7900green700#2e5b00
Orange
Token Value orange100#fffae6orange200#ffeeb4orange300#ffe380orange400#ffc400orange500#ffab00orange600#ff991forange700#a94700
Red
Token Value red100#ffebe6red200#ffbdadred300#ff8f73red400#ff7452red500#ff5630red600#de350bred700#970900
Grey
Token Value grey100#f9f9f9grey150#f1f1f1grey200#e8e8e8grey300#e0e0e0grey400#ccd0dbgrey500#838dadgrey600#666e89grey650#666e89grey700#162858
Use descriptive style names that reflect purpose rather than appearance: readOnlyStyle, criticalCell, warningHeader rather than greyBackground or redText. This makes configurations easier to maintain when color schemes change.
Complete YAML Example
columns :
outlineNumber :
title : "#"
width : 80
formatter : readonly
isReadOnly : true
title :
title : Title
width : 200
hasFocus : true
columnGroup : requirements
description :
title : Description
width : 140
header :
style : lightpurple
columnGroups :
requirements :
groupName : Requirements
groupStyle : darkblue
headerStyle : blue
collapseTo : title
formatters :
readonly :
- expression : 'true'
style : readOnlyStyle
criticalHighlight :
- expression : 'true'
style : criticalCell
styles :
readOnlyStyle :
backgroundColor : 'grey100'
criticalCell :
backgroundColor : 'red100'
color : 'red700'
fontWeight : 600
Related Pages
Source references: powersheet.yaml, column-column-group-header-styles KB article, ConfigProvider.tsx (DEFAULT_STYLES)
KB Articles Source Code
powersheet.yaml
prod-powersheet-src/com.nextedy.powersheet.client/src/modules/Powersheet/Powersheet.tsx
prod-powersheet-src/com.nextedy.powersheet/src/com/nextedy/powersheet/PowersheetService.java
prod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/sheet/SheetComponent.tsx
prod-powersheet-src/com.nextedy.powersheet.client/src/modules/ConfigProvider/ConfigProvider.tsx