Skip to content

Configuration reference ​

This page shows each section and field of the default schema. A script makes the tables from the field metadata in the source code.

A path has the format <section>.<field>. Use a path in the locked option. In the config option and in setConfig, use an object for each section.

Each section other than theme also has the field enabled. The default value is true.

theme ​

PathTypeDefaultRangeDescription
theme.colorColor#fad30b#rrggbbThe color of each section that has no color of its own.
theme.motionauto, full, reduced, offfullThe motion mode. The value "auto" follows the reduced motion option of the system.
theme.maxDprNumber1.51 to 3, step 0.5The maximum device pixel ratio of the canvas.

cloud ​

PathTypeDefaultRangeDescription
cloud.sizeNumber1810 to 150, step 1The minimum radius of a new cloud in pixels.
cloud.densityNumber0.50.1 to 1, step 0.05The chance of a new cloud in each frame while the pointer moves.
cloud.bounceNumber1500 to 150, step 1The range of the noise wobble in pixels. The value 0 stops the wobble.
cloud.spreadNumber500 to 200, step 1The size of the area around the pointer where new clouds start.
cloud.fadeRateNumber0.0350.001 to 0.05, step 0.001The speed at which a cloud disappears.
cloud.colorColor or null#fad30b#rrggbbThe color of the clouds. The value null uses the theme color.
cloud.maxCloudsNumber3481 to 1000, step 1The maximum number of clouds on the screen.
cloud.enabledBooleantrueThe section operates only when this value is true.

chalk ​

PathTypeDefaultRangeDescription
chalk.sizeNumber141 to 50, step 1The width of the stroke in pixels.
chalk.maxLengthNumber153050 to 2000, step 10The maximum length of a stroke in pixels. The oldest part of the stroke dissolves.
chalk.smoothingNumber0.350 to 0.95, step 0.05The steadiness of the line. The value 0 uses the raw pointer positions.
chalk.softnessNumber0.650 to 1, step 0.05The width of the feathered edge. The value 0 gives a crisp edge.
chalk.taperNumber0.250 to 1, step 0.05The length of the thin tips at the two ends of the stroke.
chalk.fadeRateNumber0.0390.001 to 0.05, step 0.001The speed at which a finished stroke disappears.
chalk.colorColor or nullnull (uses theme.color)#rrggbbThe color of the chalk. The value null uses the theme color.
chalk.enabledBooleantrueThe section operates only when this value is true.

glitter ​

PathTypeDefaultRangeDescription
glitter.sizeNumber61 to 50, step 1The base size of a glitter particle in pixels.
glitter.spawnRateNumber31 to 20, step 1The minimum number of particles for each burst.
glitter.gravityNumber0.02-0.1 to 0.2, step 0.01The downward pull on each particle. A negative value lifts the particles.
glitter.frictionNumber0.940.8 to 1, step 0.01The part of the speed that a particle keeps in each frame.
glitter.fadeRateNumber0.0150.001 to 0.05, step 0.001The speed at which a particle disappears.
glitter.twinkleNumber51 to 20, step 1The sharpness of the twinkle. A high value gives short flashes.
glitter.colorColor or nullnull (uses theme.color)#rrggbbThe color of the glitter. The value null uses the theme color.
glitter.maxParticlesNumber9791 to 5000, step 1The maximum number of glitter particles on the screen.
glitter.enabledBooleantrueThe section operates only when this value is true.

cursor ​

PathTypeDefaultRangeDescription
cursor.glowSizeNumber800 to 240, step 2The diameter of the glow in pixels. The value 0 removes the glow.
cursor.glowStrengthNumber0.550 to 1, step 0.05The opacity of the glow.
cursor.glowPressNumber1.251 to 2.5, step 0.05The scale of the glow while the pointer button is down.
cursor.colorColor or nullnull (uses theme.color)#rrggbbThe color of the glow. The value null uses the theme color.
cursor.enabledBooleantrueThe section operates only when this value is true.