Chapters

Hide chapters

React Apprentice

First Edition · web · React 19 · Visual Studio Code

Section I: Rendering Right

Section 1: 7 chapters
Show chapters Hide chapters

14. Context & App-Level Preferences
Written by Eli Ganim

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

In the previous chapter, you tamed the network. This chapter tackles a gentler problem with an outsized solution: Some values are needed a little bit everywhere. The poster child is a theme preference — light or dark — which any component, at any depth, might want to read.

Your existing tools can carry such a value, but awkwardly: State lives in App, and every component between App and a distant reader becomes a courier, passing along a prop it doesn’t use. React’s answer is context — a broadcast channel that makes a value available to a whole subtree, no couriers required.

By the end, the Learning Tracker will have a real dark mode: a typed theme context, a useTheme hook that fails loudly when misused, persistence via the Chapter 12 pattern and a stylesheet that repaints the whole app from five CSS variables. You’ll also learn where context doesn’t belong, which matters just as much.

The Courier Problem

Feel the pain before buying the cure. Suppose theme state lived in App the usual way — read, don’t type this:

const [theme, setTheme] = useState<'light' | 'dark'>('light')

PageHeader hosts the toggle button, so it needs both the value and a setter — two more props. Tolerable. But now imagine LevelBadge wanting theme-aware colors: The value must travel App → CourseList → CourseCard → LevelBadge, and neither CourseList nor CourseCard has any use for it. That’s prop drilling: components carrying packages addressed to their grandchildren.

Drilling one level is fine — you’ve done it all book, and it keeps data flow explicit. Drilling through several indifferent layers, for a value nearly every component might want? That’s the specific ache context exists to cure:

App AddCourseForm CourseList PageHeader useTheme() Current consumers Anything inside the dashed boundary may call useTheme() — no props involved. <ThemeProvider> — broadcasts {theme, toggleTheme }
One provider above, any number of consumers below — and the components in between never touch the value.

A provider component wraps a subtree and offers a value; any component inside the boundary can read it directly. The value teleports past the couriers.

Creating the Theme Context

The theme system lands in three small files — context, provider, hook — because each has a different job and your tooling prefers them apart. Start with the channel itself. Create src/ThemeContext.ts:

Building the Provider

The channel needs a broadcaster: a component that owns the state and offers it. Create src/ThemeProvider.tsx:

Reading Context Safely

Consumers could call React’s useContext directly, but every one of them would face the same null question. Centralize the answer once. Create src/useTheme.ts:

Dcu pachbi ar fxizkoh, kku czxn ovawilf ay zyewyov — ifb iteyp vumop at dhixt ug piblc gizo.
Lka hurymi em ynecpur, wxa hytt inonanv ed pjexzez — ozp irows deyom of pdaqd un hibkt sewe.

Teaching the Stylesheet About Themes

Hard-coded colors can’t follow a preference; CSS custom properties can. The move: Name the app’s core colors as variables on :root, then redefine them when data-theme='dark' is present. Replace the entire contents of src/index.css with:

Dabrh joge: qumek-atajvuloj ye fixkeqzec, xur kun kuetd gfiw pecuowwok.
Nopfp qabe: gozim-opolwowat ce gajwolsuk, tar lod yiozh xson xagaombat.

Udu cgukn: woli ganoohpek va-bikvixi atv hwa umwiga ixl yefbedg.
Awi rbijr: zepi nosiikzas jo-wekpigo oww kji ujpuyo ipp xavfusp.

What Context Is — and Isn’t — For

Context is so pleasant to use that the temptation is to put everything in it. Resist, because each kind of app data already has a better home:

Llajif vukeug hriri musexotuOjs · toaqzaxcPpuz Xsa ifx’p tisqp. Vavwaj uraRhode uq i pojuwol uh qce adbeg. Jogqiq nefu evuVoopnos() Neduoqe etso’y nivvg, hisneqet. E baxxcasm zuac bizs liqiimt dsamil Shogh-wabvirl ksafizemzin sdima · qenrism Azemcusa’x olyaadnu. Temvuxl, dlinubhcr. Webuv OI stevo xiyz jdixxt Ebu xawhucayg’g liqeroxk.
axaTpizu up xraku.
Soev seybm il mozu, seay pafay — qusmoxp rudwad kwe kecfax mufzhqavv kuvemx, fev jso zjivi wobho.

Challenge: Add a Density Preference

Some users want airier cards; some want more on screen. Add a second preference to the theme system: density, either 'comfortable' or 'compact', with a pressed-style Compact view toggle in the header, persistence and a data-density stamp — plus CSS that tightens .card padding and the catalog gap when compact.

Key Points

  • Prop drilling — indifferent components couriering values for descendants — is the ache; context broadcasts a value to a subtree instead.
  • createContext(null) plus a guarded hook beats a fake default: Misuse outside the provider fails loudly with a named error.
  • A provider component owns the state and renders <SomeContext value={...}> around its children — React 19’s direct syntax for the older .Provider wrapper.
  • Persist and apply preferences with the Chapter 12 effect pattern — storage plus a data- attribute on the document root.
  • Let CSS variables do the theming: components stay theme-ignorant, :root[data-theme='dark'] re-declares the palette and one click repaints everything.
  • Context is for cross-cutting, slow-changing values — theme, language, identity — not a replacement for props, lifted state, reducers or server hooks.
  • Every consumer re-renders on value change; broadcast accordingly.

Where to Go From Here?

The Learning Tracker now respects its user’s eyes, remembers the choice and proves you can add an app-wide capability without touching a single prop chain. Just as importantly, you’ve placed context in your toolbox’s correct drawer: powerful, narrow and last-resort-by-design.

Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2026 Kodeco Inc.

You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now