Skip to main content

Guides

Each guide here solves one job, with a complete example you can paste in and adapt. They build on How comb works, so read that first if sources, puts and templates are new. A value's life explains how a value is kept current.

Pick the guide for your value​

I want to show…Guide
text shaped, coloured or worked out with comb's own functionsTemplate functions
the output of a command or scriptFrom a command
something from a file, like a version in package.jsonFrom files
something from a web APIFrom an HTTP API
something another program knows, like a deploy statusData you push
a fixed value, or one built from other valuesTemplate namespaces
a built-in value, but checked more often, shown differently, or not at allChange a built-in provider
something only native code can get cheaplyShared-library plugins

The cheapest way first​

If more than one guide fits, pick the one that does the least work per update: reading a file costs least, then a web request, then running a command. A program that already knows the value and puts it costs nothing to keep fresh.