Version: 3.2.2

Default Theme

The theme object is where you define your application's color palette, type scale, font stacks, breakpoints, border radius values, and more.

Theming in NativeBase is based on the Styled System Theme Specification

Colors#

You can add a theme.colors object to provide colors for your project. By default these colors can be referenced by the colorborderColorbackgroundColor, etc.. props. You can also add .alpha:{number} to add levels of opacity to a colour. The number can also be added in the theme file. Ex: red.300:alpha.30, You can read more about this in opacity section

We recommend adding a palette that ranges from 50 to 900. Tools like Smart Swatch, Palx are available to generate these palettes.

primary

primary.50
#ecfeff
primary.100
#cffafe
primary.200
#a5f3fc
primary.300
#67e8f9
primary.400
#22d3ee
primary.500
#06b6d4
primary.600
#0891b2
primary.700
#0e7490
primary.800
#155e75
primary.900
#164e63

secondary

secondary.50
#fdf2f8
secondary.100
#fce7f3
secondary.200
#fbcfe8
secondary.300
#f9a8d4
secondary.400
#f472b6
secondary.500
#ec4899
secondary.600
#db2777
secondary.700
#be185d
secondary.800
#9d174d
secondary.900
#831843

tertiary

tertiary.50
#ecfdf5
tertiary.100
#d1fae5
tertiary.200
#a7f3d0
tertiary.300
#6ee7b7
tertiary.400
#34d399
tertiary.500
#10b981
tertiary.600
#059669
tertiary.700
#047857
tertiary.800
#065f46
tertiary.900
#064e3b

danger

danger.50
#fff1f2
danger.100
#ffe4e6
danger.200
#fecdd3
danger.300
#fda4af
danger.400
#fb7185
danger.500
#f43f5e
danger.600
#e11d48
danger.700
#be123c
danger.800
#9f1239
danger.900
#881337

error

error.50
#fef2f2
error.100
#fee2e2
error.200
#fecaca
error.300
#fca5a5
error.400
#f87171
error.500
#ef4444
error.600
#dc2626
error.700
#b91c1c
error.800
#991b1b
error.900
#7f1d1d

success

success.50
#f0fdf4
success.100
#dcfce7
success.200
#bbf7d0
success.300
#86efac
success.400
#4ade80
success.500
#22c55e
success.600
#16a34a
success.700
#15803d
success.800
#166534
success.900
#14532d

warning

warning.50
#fff7ed
warning.100
#ffedd5
warning.200
#fed7aa
warning.300
#fdba74
warning.400
#fb923c
warning.500
#f97316
warning.600
#ea580c
warning.700
#c2410c
warning.800
#9a3412
warning.900
#7c2d12

muted

muted.50
#fafafa
muted.100
#f5f5f5
muted.200
#e5e5e5
muted.300
#d4d4d4
muted.400
#a3a3a3
muted.500
#737373
muted.600
#525252
muted.700
#404040
muted.800
#262626
muted.900
#171717

info

info.50
#f0f9ff
info.100
#e0f2fe
info.200
#bae6fd
info.300
#7dd3fc
info.400
#38bdf8
info.500
#0ea5e9
info.600
#0284c7
info.700
#0369a1
info.800
#075985
info.900
#0c4a6e

light

light.50
#fafaf9
light.100
#f5f5f4
light.200
#e7e5e4
light.300
#d6d3d1
light.400
#a8a29e
light.500
#78716c
light.600
#57534e
light.700
#44403c
light.800
#292524
light.900
#1c1917

singletons

white
#FFFFFF
black
#000000
lightText
#FFFFFF
darkText
#27272a

rose

rose.50
#fff1f2
rose.100
#ffe4e6
rose.200
#fecdd3
rose.300
#fda4af
rose.400
#fb7185
rose.500
#f43f5e
rose.600
#e11d48
rose.700
#be123c
rose.800
#9f1239
rose.900
#881337

pink

pink.50
#fdf2f8
pink.100
#fce7f3
pink.200
#fbcfe8
pink.300
#f9a8d4
pink.400
#f472b6
pink.500
#ec4899
pink.600
#db2777
pink.700
#be185d
pink.800
#9d174d
pink.900
#831843

fuchsia

fuchsia.50
#fdf4ff
fuchsia.100
#fae8ff
fuchsia.200
#f5d0fe
fuchsia.300
#f0abfc
fuchsia.400
#e879f9
fuchsia.500
#d946ef
fuchsia.600
#c026d3
fuchsia.700
#a21caf
fuchsia.800
#86198f
fuchsia.900
#701a75

purple

purple.50
#faf5ff
purple.100
#f3e8ff
purple.200
#e9d5ff
purple.300
#d8b4fe
purple.400
#c084fc
purple.500
#a855f7
purple.600
#9333ea
purple.700
#7e22ce
purple.800
#6b21a8
purple.900
#581c87

violet

violet.50
#f5f3ff
violet.100
#ede9fe
violet.200
#ddd6fe
violet.300
#c4b5fd
violet.400
#a78bfa
violet.500
#8b5cf6
violet.600
#7c3aed
violet.700
#6d28d9
violet.800
#5b21b6
violet.900
#4c1d95

indigo

indigo.50
#eef2ff
indigo.100
#e0e7ff
indigo.200
#c7d2fe
indigo.300
#a5b4fc
indigo.400
#818cf8
indigo.500
#6366f1
indigo.600
#4f46e5
indigo.700
#4338ca
indigo.800
#3730a3
indigo.900
#312e81

blue

blue.50
#eff6ff
blue.100
#dbeafe
blue.200
#bfdbfe
blue.300
#93c5fd
blue.400
#60a5fa
blue.500
#3b82f6
blue.600
#2563eb
blue.700
#1d4ed8
blue.800
#1e40af
blue.900
#1e3a8a

lightBlue

lightBlue.50
#f0f9ff
lightBlue.100
#e0f2fe
lightBlue.200
#bae6fd
lightBlue.300
#7dd3fc
lightBlue.400
#38bdf8
lightBlue.500
#0ea5e9
lightBlue.600
#0284c7
lightBlue.700
#0369a1
lightBlue.800
#075985
lightBlue.900
#0c4a6e

darkBlue

darkBlue.50
#dbf4ff
darkBlue.100
#addbff
darkBlue.200
#7cc2ff
darkBlue.300
#4aa9ff
darkBlue.400
#1a91ff
darkBlue.500
#0077e6
darkBlue.600
#005db4
darkBlue.700
#004282
darkBlue.800
#002851
darkBlue.900
#000e21

cyan

cyan.50
#ecfeff
cyan.100
#cffafe
cyan.200
#a5f3fc
cyan.300
#67e8f9
cyan.400
#22d3ee
cyan.500
#06b6d4
cyan.600
#0891b2
cyan.700
#0e7490
cyan.800
#155e75
cyan.900
#164e63

teal

teal.50
#f0fdfa
teal.100
#ccfbf1
teal.200
#99f6e4
teal.300
#5eead4
teal.400
#2dd4bf
teal.500
#14b8a6
teal.600
#0d9488
teal.700
#0f766e
teal.800
#115e59
teal.900
#134e4a

emerald

emerald.50
#ecfdf5
emerald.100
#d1fae5
emerald.200
#a7f3d0
emerald.300
#6ee7b7
emerald.400
#34d399
emerald.500
#10b981
emerald.600
#059669
emerald.700
#047857
emerald.800
#065f46
emerald.900
#064e3b

green

green.50
#f0fdf4
green.100
#dcfce7
green.200
#bbf7d0
green.300
#86efac
green.400
#4ade80
green.500
#22c55e
green.600
#16a34a
green.700
#15803d
green.800
#166534
green.900
#14532d

lime

lime.50
#f7fee7
lime.100
#ecfccb
lime.200
#d9f99d
lime.300
#bef264
lime.400
#a3e635
lime.500
#84cc16
lime.600
#65a30d
lime.700
#4d7c0f
lime.800
#3f6212
lime.900
#365314

yellow

yellow.50
#fefce8
yellow.100
#fef9c3
yellow.200
#fef08a
yellow.300
#fde047
yellow.400
#facc15
yellow.500
#eab308
yellow.600
#ca8a04
yellow.700
#a16207
yellow.800
#854d0e
yellow.900
#713f12

amber

amber.50
#fffbeb
amber.100
#fef3c7
amber.200
#fde68a
amber.300
#fcd34d
amber.400
#fbbf24
amber.500
#f59e0b
amber.600
#d97706
amber.700
#b45309
amber.800
#92400e
amber.900
#78350f

orange

orange.50
#fff7ed
orange.100
#ffedd5
orange.200
#fed7aa
orange.300
#fdba74
orange.400
#fb923c
orange.500
#f97316
orange.600
#ea580c
orange.700
#c2410c
orange.800
#9a3412
orange.900
#7c2d12

red

red.50
#fef2f2
red.100
#fee2e2
red.200
#fecaca
red.300
#fca5a5
red.400
#f87171
red.500
#ef4444
red.600
#dc2626
red.700
#b91c1c
red.800
#991b1b
red.900
#7f1d1d

warmGray

warmGray.50
#fafaf9
warmGray.100
#f5f5f4
warmGray.200
#e7e5e4
warmGray.300
#d6d3d1
warmGray.400
#a8a29e
warmGray.500
#78716c
warmGray.600
#57534e
warmGray.700
#44403c
warmGray.800
#292524
warmGray.900
#1c1917

trueGray

trueGray.50
#fafafa
trueGray.100
#f5f5f5
trueGray.200
#e5e5e5
trueGray.300
#d4d4d4
trueGray.400
#a3a3a3
trueGray.500
#737373
trueGray.600
#525252
trueGray.700
#404040
trueGray.800
#262626
trueGray.900
#171717

gray

gray.50
#fafafa
gray.100
#f4f4f5
gray.200
#e4e4e7
gray.300
#d4d4d8
gray.400
#a1a1aa
gray.500
#71717a
gray.600
#52525b
gray.700
#3f3f46
gray.800
#27272a
gray.900
#18181b

coolGray

coolGray.50
#f9fafb
coolGray.100
#f3f4f6
coolGray.200
#e5e7eb
coolGray.300
#d1d5db
coolGray.400
#9ca3af
coolGray.500
#6b7280
coolGray.600
#4b5563
coolGray.700
#374151
coolGray.800
#1f2937
coolGray.900
#111827

blueGray

blueGray.50
#f8fafc
blueGray.100
#f1f5f9
blueGray.200
#e2e8f0
blueGray.300
#cbd5e1
blueGray.400
#94a3b8
blueGray.500
#64748b
blueGray.600
#475569
blueGray.700
#334155
blueGray.800
#1e293b
blueGray.900
#0f172a

dark

dark.50
#18181b
dark.100
#27272a
dark.200
#3f3f46
dark.300
#52525b
dark.400
#71717a
dark.500
#a1a1aa
dark.600
#d4d4d8
dark.700
#e4e4e7
dark.800
#f4f4f5
dark.900
#fafafa

Typography#

To manage Typography options, the theme object supports the following keys:

  • fonts (font families)
  • fontSizes
  • fontWeights
  • lineHeights
  • letterSpacings
const typography = {
letterSpacings: {
xs: '-0.05em',
sm: '-0.025em',
md: 0,
lg: '0.025em',
xl: '0.05em',
'2xl': '0.1em',
},
lineHeights: {
'2xs': '1em',
xs: '1.125em',
sm: '1.25em',
md: '1.375em',
lg: '1.5em',
xl: '1.75em',
'2xl': '2em',
'3xl': '2.5em',
'4xl': '3em',
'5xl': '4em',
},
fontWeights: {
hairline: 100,
thin: 200,
light: 300,
normal: 400,
medium: 500,
semibold: 600,
bold: 700,
extrabold: 800,
black: 900,
extrablack: 950,
},
fonts: {
heading: undefined,
body: undefined,
mono: undefined,
},
fontSizes: {
'2xs': 10,
xs: 12,
sm: 14,
md: 16,
lg: 18,
xl: 20,
'2xl': 24,
'3xl': 30,
'4xl': 36,
'5xl': 48,
'6xl': 60,
'7xl': 72,
'8xl': 96,
'9xl': 128,
},
};
2xs
The quick brown fox jumped over the lazy dog.
xs
The quick brown fox jumped over the lazy dog.
sm
The quick brown fox jumped over the lazy dog.
md
The quick brown fox jumped over the lazy dog.
lg
The quick brown fox jumped over the lazy dog.
xl
The quick brown fox jumped over the lazy dog.
2xl
The quick brown fox jumped over the lazy dog.
3xl
The quick brown fox jumped over the lazy dog.
4xl
The quick brown fox jumped over the lazy dog.
5xl
The quick brown fox jumped over the lazy dog.
6xl
The quick brown fox jumped over the lazy dog.
7xl
The quick brown fox jumped over the lazy dog.
8xl
The quick brown fox jumped over the lazy dog.
9xl
The quick brown fox jumped over the lazy dog.

Size#

The size key allows you to customize the global spacing and sizing scale for your project. By default these spacing value can be referenced by the paddingmargin, and topleftrightbottom props.

Value Pixels Representation
00
14
28
312
416
520
624
728
832
936
1040
1248
1664
2080
2496
32128
40160
48192
56224
64256
72288
80320
96384
px1px
0.52
1.56
2.510
3.514
1/250%
1/333.333%
2/366.666%
1/425%
2/450%
3/475%
1/520%
2/540%
3/560%
4/580%
1/616.666%
2/633.333%
3/650%
4/666.666%
5/683.333%
full100%

Opacity#

The opacity key is used in opacity style object and to define colors opacity using the red-green-blue-alpha (RGBA) model, RGBA color values are an extension of RGB color values with an alpha channel - which specifies the opacity of the color.

const opacity = {
0: 0,
5: 0.05,
10: 0.1,
20: 0.2,
25: 0.25,
30: 0.3,
40: 0.4,
50: 0.5,
60: 0.6,
70: 0.7,
75: 0.75,
80: 0.8,
90: 0.9,
95: 0.95,
100: 1,
};

Shadows#

The shadow key allows you to customize the global box shadow for your project.

export default {
0: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 1,
},
shadowOpacity: 0.18,
shadowRadius: 1.0,
elevation: 1,
},
1: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 1,
},
shadowOpacity: 0.2,
shadowRadius: 1.41,
elevation: 2,
},
2: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 1,
},
shadowOpacity: 0.22,
shadowRadius: 2.22,
elevation: 3,
},
3: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 2,
},
shadowOpacity: 0.23,
shadowRadius: 2.62,
elevation: 4,
},
4: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 2,
},
shadowOpacity: 0.25,
shadowRadius: 3.84,
elevation: 5,
},
5: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 3,
},
shadowOpacity: 0.27,
shadowRadius: 4.65,
elevation: 6,
},
6: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 3,
},
shadowOpacity: 0.29,
shadowRadius: 4.65,
elevation: 7,
},
7: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 4,
},
shadowOpacity: 0.3,
shadowRadius: 4.65,
elevation: 8,
},
8: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 4,
},
shadowOpacity: 0.32,
shadowRadius: 5.46,
elevation: 9,
},
9: {
shadowColor: '#000',
shadowOffset: {
width: 0,
height: 5,
},
shadowOpacity: 0.34,
shadowRadius: 6.27,
elevation: 10,
},
};

Still confused? You can always explore here.