<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Stalefish Labs</title>
    <description>The latest articles on DEV Community by Stalefish Labs (@stalefishlabs).</description>
    <link>https://dev.to/stalefishlabs</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3804354%2F33f3ff10-d356-4d75-826e-d7c1cc83e41a.png</url>
      <title>DEV Community: Stalefish Labs</title>
      <link>https://dev.to/stalefishlabs</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/stalefishlabs"/>
    <language>en</language>
    <item>
      <title>Anatomy of a Skateboard Ramp: 3D Visualization and Materials Math</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Wed, 15 Apr 2026 20:02:19 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/anatomy-of-a-skateboard-ramp-3d-visualization-and-materials-math-4ej4</link>
      <guid>https://dev.to/stalefishlabs/anatomy-of-a-skateboard-ramp-3d-visualization-and-materials-math-4ej4</guid>
      <description>&lt;p&gt;I have a joke that if you ever meet a skateboarder over the age of 40, you're likely looking a reasonably accomplished amateur carpenter. It was historically a DIY sport, and many of us learned how to build ramps more or less on our own, with mixed results. Building a skateboard ramp isn't necessarily expert level carpentry, but there are important details and some common conventions that matter a great deal. For many of us, it was an exercise in optimism meeting carpentry. You start with a vision, a backyard quarterpipe or maybe a garage mini ramp, and quickly drown in questions. How tall, what radius, how many sheets of plywood? What about Skatelite or some other composite surface, even remotely in budget? What lumber lengths do I need? Will it actually look like the thing in my head?&lt;/p&gt;

&lt;p&gt;After I had a friend lament having no clue how much his new dream ramp might cost, I thought wouldn't it be cool to have a little lightweight CAD'ish tool for visualizing and obtaining a materials list for skateboard ramps. I built the &lt;a href="https://dev.to/experiments/ramp-designer/"&gt;Ramp Designer&lt;/a&gt; to answer the tricky questions surrounding ramp design, and help my friend come up with a budget for his ramp. It's a free, browser-based tool that generates a real-time 3D model of your ramp and calculates a complete materials list, down to the screw count.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why Ramp Design Is Harder Than It Looks
&lt;/h2&gt;

&lt;p&gt;Before going any further, it's worth noting that I'm specifically talking about curved skateboard ramps where the curve follows a fixed radius. In skateparks you will no doubt find banks, ledges, slants, and maybe even curved ramps with elliptical (varying) transitions, but classic quarterpipes and halfpipes you see in backyards or X-Games Vert are the focus here. Given that, a wooden skateboard ramp follows a certain recipe to allow for the curve via a layered construction: plywood side templates cut to a precise arc profile (radius), structural ribs running across the width, a plywood deck at the top, two layers of surface plywood bent over the ribs, now days mercifully a specialized riding surface on top of that, and a steel coping pipe at the lip. Each layer has its own material, its own fastener requirements, and its own set of constraints. And by the way, I said mercifully about the top surface because modern skate-specific composite surfaces like Skatelike, Ramp Armor, and Gator Skins dramatically improve the safety and usability of ramps - no more rot, and no more splinters!&lt;/p&gt;

&lt;p&gt;The curve itself, the transition, is what makes a ramp a ramp and not a wedge. A good transition follows a circular arc carefully matched to the height of the ramp, and the radius of that arc determines how the ramp feels to ride. A tight radius (small number) produces a quick, steep, snappy transition. A large radius creates a mellow, flowing curve. The relationship between height, radius, and the resulting arc length drives every other calculation in the build. And generally speaking there isn't entirely a right or wrong, just extremes. For example, an extremely tight radius is more like a backyard pool like you might've seen in the Dogtown and Z-Boys documentary.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Arc: Circular Geometry in Practice
&lt;/h2&gt;

&lt;p&gt;The transition profile is a circular arc. Given a ramp height &lt;code&gt;h&lt;/code&gt; and a transition radius &lt;code&gt;r&lt;/code&gt;, the arc sweeps from horizontal (the flat approach) to vertical (or near-vertical at the lip). The math is clean:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;θ_max = acos(1 - h/r)    // when h ≤ r
arc_length = r × θ_max
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For mini ramp transitions where the height is less than or equal to the radius, this produces a smooth curve from 0° to θ_max, meaning the curve never makes it to 90°, it never reaches vertical. But some ramps deliberately go vertical, the height exceeds the radius, and that makes them vert ramps. In that case, the curve is a full quarter circle (90°) plus a straight vertical section at the top:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;// Vert ramp (h &amp;gt; r)
arc_length = r × π/2 + (h - r)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The simulator generates the arc as an array of coordinate pairs, sampling the curve at regular angular intervals. These points define the side template profile that gets cut from plywood, and they're the foundation for positioning every rib, surface sheet, and seam line in the 3D model.&lt;/p&gt;

&lt;h3&gt;
  
  
  Curve Offsetting for Layers
&lt;/h3&gt;

&lt;p&gt;A ramp has ribs inset and flush to the transition curve with multiple layers stacked on top, typically two subsurface plywood layers, followed by a third riding surface layer. Each layer needs to follow the same curve, but offset outward by the material's thickness. It's worth noting some metal-framed ramps like Tony Hawk's famous portable warehouse ramp forego the two layers of subsurface and just go with one, but the ramp is engineered specifically to allow that.&lt;/p&gt;

&lt;p&gt;To get the radius to straighten to vert involves offsetting the circular arc, which is straightforward in theory (just increase the radius), but the simulator handles it with a general-purpose &lt;code&gt;offsetCurve()&lt;/code&gt; function that works on arbitrary point arrays. At each point, it computes the perpendicular normal using the slope between neighboring points, then shifts the point outward by the offset distance.&lt;/p&gt;

&lt;p&gt;This approach handles the transition from arc to vertical extension seamlessly, without special-casing the geometry at the inflection point.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Materials Engine
&lt;/h2&gt;

&lt;p&gt;The materials calculator is where abstract geometry meets the lumber yard. Every dimension in the model maps to a real-world purchase decision, and the calculator accounts for constraints that CAD software ignores.&lt;/p&gt;

&lt;h3&gt;
  
  
  Lumber Length Rounding
&lt;/h3&gt;

&lt;p&gt;You can't buy a 9-foot 2x6. Lumber comes in standard lengths: typically 8', 10', 12', 14', and 16'. The calculator rounds every piece up to the nearest available length. A rib that measures 8'3" in the model becomes a 10-footer on the shopping list. This is a small detail that prevents a lot of frustration at the lumber yard. It also helps you use the designer as a playground to experiment with materials sweet spots - wider is always better for skateboard ramps, and being able to know exactly the price difference between +4' and +8' in width is a big deal.&lt;/p&gt;

&lt;h3&gt;
  
  
  Sheet Goods Efficiency
&lt;/h3&gt;

&lt;p&gt;Plywood comes in 4×8 sheets. The calculator optimizes sheet counts by checking whether multiple pieces can be cut from a single sheet. For side templates, if the ramp height is 48" or less and the arc length fits within 96", two sides can be cut from one sheet. Taller vert ramps need a multiple sheets per side, and the 3D model shows the horizontal seam at 4 feet where the two pieces join.&lt;/p&gt;

&lt;p&gt;Surface plywood is simpler: the calculator computes total surface area (arc length × width), divides by 32 square feet per sheet, and rounds up. Two layers are always used — the inner layer provides structural rigidity while the outer layer creates a smooth riding surface. Currently the tool forces 4x8 sheets, which is correct for plywood but specialty surfaces like Skatelite also come in larger dimensions up to 5x12 - that may be a future addition to the tool.&lt;/p&gt;

&lt;h3&gt;
  
  
  Rib Spacing and T-Ribs
&lt;/h3&gt;

&lt;p&gt;Ribs are the structural backbone of the transition. They run perpendicular to the riding direction, spaced at regular intervals along the arc. The simulator offers three spacing options:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Spacing&lt;/th&gt;
&lt;th&gt;Use Case&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;6" on center&lt;/td&gt;
&lt;td&gt;Overbuilt — heavy but bomber&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;8" on center&lt;/td&gt;
&lt;td&gt;Standard — recommended for most builds&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;12" on center&lt;/td&gt;
&lt;td&gt;Budget — lighter, not ideal except for very small ramps&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;But ribs aren't uniform. And this is where some ramp builders diverge and have different techniques, but I like this one. Every 4 feet along the arc (where surface plywood sheets butt together), the simulator places a &lt;strong&gt;T-rib&lt;/strong&gt; instead of a standard rib. A T-rib is constructed out of two ribs joined together to form a T, providing more surface for the plywood sheets to meet and form a seam. Think of it as a rib T having a cap perpendicular to the stem, creating a wider bearing surface at the sheet seam. This prevents the plywood edges from telegraphing through the riding surface over time.&lt;/p&gt;

&lt;p&gt;The 3D model clearly renders T-ribs so builders can identify them during assembly. It's somewhat a matter of construction preference where you start the T's, as it has to do with where you start the plywood sheets. What's important is that the T's form a predictable pattern so that at least the first layer of plywood seams always meet on a T, for example every 4'.&lt;/p&gt;

&lt;h3&gt;
  
  
  Fastener Estimation
&lt;/h3&gt;

&lt;p&gt;Screws are the most tedious part of a materials list. The calculator estimates counts based on fastener density per component:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Structural screws&lt;/strong&gt; (#10 × 3"): rib-to-side connections, framing joints, deck joists&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Surface screws&lt;/strong&gt; (#8 × 2"): plywood surface layers, riding surface material&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Counts are rounded to the nearest 25 or 50 to match bulk packaging. For outdoor builds, the calculator specifies coated or stainless fasteners and adds a note about corrosion resistance. Screws are definitely the one part of the build where you can use your own judgement if you find something you like in a slightly different length. There's also debate over whether screws in the final riding surface should align hit ribs - manufacturers say yes, practical ramp builders sometimes say no.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Full Shopping List
&lt;/h3&gt;

&lt;p&gt;A complete materials list for a typical 4-foot tall, 8-foot wide quarterpipe might include:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Material&lt;/th&gt;
&lt;th&gt;Quantity&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;3/4" Plywood (sides)&lt;/td&gt;
&lt;td&gt;2 sheets&lt;/td&gt;
&lt;td&gt;Side templates&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3/8" Plywood (surface)&lt;/td&gt;
&lt;td&gt;4 sheets&lt;/td&gt;
&lt;td&gt;Two layers&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2×6 × 8'&lt;/td&gt;
&lt;td&gt;12&lt;/td&gt;
&lt;td&gt;Ribs (includes T-ribs)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4×4 × 4'&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;Back support posts&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2×4 × 8'&lt;/td&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;Deck joists, plates&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2⅜" Steel pipe × 8'&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;Coping&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Skatelite 4×8&lt;/td&gt;
&lt;td&gt;2 sheets&lt;/td&gt;
&lt;td&gt;Riding surface&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;#10 × 3" screws&lt;/td&gt;
&lt;td&gt;150&lt;/td&gt;
&lt;td&gt;Structural&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;#8 × 2" screws&lt;/td&gt;
&lt;td&gt;200&lt;/td&gt;
&lt;td&gt;Surface&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The half pipe configuration doubles most of these quantities and adds flat bottom materials (joists, surface, framing).&lt;/p&gt;

&lt;h2&gt;
  
  
  The 3D Model: Eight Layers Deep
&lt;/h2&gt;

&lt;p&gt;The 3D visualization is built with Three.js and renders the ramp as eight distinct layer groups:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Sides&lt;/strong&gt; — 3/4" plywood transition templates (don't skimp and go thinner with these)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ribs&lt;/strong&gt; — 2×6 or 2×4 structural members following the arc&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Back Frame&lt;/strong&gt; — 4×4 posts and plates supporting the deck&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deck&lt;/strong&gt; — 3/4" plywood platform with joists&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Surface Layer 1&lt;/strong&gt; — 3/8" plywood&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Surface Layer 2&lt;/strong&gt; — 3/8" plywood&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Top Surface&lt;/strong&gt; — Riding material (Skatelite, Masonite, etc.)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Coping&lt;/strong&gt; — 2⅜" steel pipe at the lip&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Each layer is a separate Three.js group, which enables the explode view, a slider that separates the layers vertically so builders can see the assembly order and understand how the pieces fit together.&lt;/p&gt;

&lt;h3&gt;
  
  
  Building the Side Templates
&lt;/h3&gt;

&lt;p&gt;The side templates are the most complex geometry in the model. They're created as &lt;code&gt;THREE.Shape&lt;/code&gt; objects, 2D profiles defined by the arc points, and then extruded to 3/4" thickness using &lt;code&gt;ExtrudeGeometry&lt;/code&gt;. The profile includes the arc curve, a vertical edge at the back, a horizontal edge at the bottom, and the deck platform at the top.&lt;/p&gt;

&lt;p&gt;For ramps taller than 4 feet, the model adds a horizontal seam line showing where two 4×8 plywood sheets would join. This is a visual reminder that tall side templates require multiple sheets and careful alignment during construction.&lt;/p&gt;

&lt;h3&gt;
  
  
  Positioning Ribs Along the Arc
&lt;/h3&gt;

&lt;p&gt;Each rib is a rectangular box positioned at a point along the arc and rotated to match the curve's tangent angle at that point. The rotation is critical, a rib that's not rotated perfectly tangent won't square up to the plywood surface, providing far less structural support.&lt;/p&gt;

&lt;p&gt;The tangent angle at any point on the arc is calculated from the slope between adjacent arc points. The rib is then rotated around its center to align perpendicular to the curve, ensuring full contact with the surface plywood.&lt;/p&gt;

&lt;h3&gt;
  
  
  Surface Sheet Seams
&lt;/h3&gt;

&lt;p&gt;Real plywood sheets are 4×8 feet. The simulator renders individual sheets with visible seams between them:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Arc seams&lt;/strong&gt; appear every 8 feet along the curve (where sheets butt end-to-end)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Width seams&lt;/strong&gt; appear every 4 feet across the ramp (where sheets sit side by side)&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These seams are rendered as thin dark lines on the outermost visible surface. They're not just cosmetic — they help builders plan sheet layout and understand where T-ribs need to be placed for support. I should add, one thing the tool doesn't do just yet is offset the seams on the plywood layers. In practice you would shift layers a fixed amount, say 2' in each dimension so that seams overlap and you don't risk future bumps in the ramp.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Coping
&lt;/h3&gt;

&lt;p&gt;The coping is a steel pipe rendered as a &lt;code&gt;THREE.CylinderGeometry&lt;/code&gt; with metallic material properties (metalness: 0.7, roughness: 0.3). It sits at the lip of the transition, where the arc meets the deck. Getting the coping position right is critical — it's the last thing a skater touches before going airborne, and in the 3D model it helps verify that the transition profile looks correct.&lt;/p&gt;

&lt;p&gt;The framing of how coping joins a ramp, or the coping pocket, is one of the trickiest aspects of ramp building, and varies widely from builder to builder. I choose a fairly straightforward approach here since the goal was more about visualizing the ramp and figuring out materials. I haven't ruled out a future coping pocket tool to break down how exactly to frame it and get the surface and deck pop dialed in. &lt;/p&gt;

&lt;h2&gt;
  
  
  Design Decisions That Mattered
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Indoor vs. Outdoor Toggle
&lt;/h3&gt;

&lt;p&gt;The environment toggle switches more than just material names. Outdoor builds use pressure-treated (PT) lumber, which is heavier, more expensive, and requires coated fasteners. The calculator updates every line item: PT 2×6 instead of 2×6, coated screws instead of standard, and adds notes about ground contact treatment for the bottom plates.&lt;/p&gt;

&lt;p&gt;This is a single checkbox that changes 30+ line items in the materials list. Getting it wrong means either building an outdoor ramp with wood that will rot in two seasons, or spending 40% more than necessary on an indoor build.&lt;/p&gt;

&lt;h3&gt;
  
  
  Section Width: 4' vs. 8'
&lt;/h3&gt;

&lt;p&gt;Section width determines how far apart the side templates are spaced. At 4-foot sections, a standard 8-foot-wide ramp has three side templates (both edges plus center) and two sections of ribs. At 8-foot sections, it has two templates (edges only) and one section of ribs. Some people like to overdo it structurally with narrower sections but 8-foot is pretty standard.&lt;/p&gt;

&lt;p&gt;The 4-foot option is labeled "overbuilt" because it doubles the plywood cost for side templates and adds significant weight. The extra rigidity prevents the surface from developing a noticeable bounce between supports but at the expense that you have to cut and assemble a lot more transitions and perfectly align them.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Explode View
&lt;/h3&gt;

&lt;p&gt;The explode slider was inspired by technical illustrations in woodworking manuals. Dragging it from 0% to 100% lifts each layer progressively — sides stay at the bottom, coping rises to the top, and everything in between fans out proportionally.&lt;/p&gt;

&lt;p&gt;The maximum separation scales with ramp height (2× the height), so a 4-foot mini ramp explodes to a manageable 8-foot spread while an 11-foot vert ramp expands to 22 feet. Surface sheets also spread apart laterally (along the z-axis) so individual sheets are visible even when multiple sheets span the width.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Transition Facts Sticker
&lt;/h3&gt;

&lt;p&gt;A small detail: the 3D model includes a procedurally generated "sticker" on the near side template, about 40% up the arc. It displays the ramp's key specs — height, radius, width, deck depth, surface material, coping presence — and an "Overall Vibe" rating based on the combination of specs.&lt;/p&gt;

&lt;p&gt;It's whimsical, but it serves a purpose: it gives the 3D model a sense of personality and makes screenshots immediately informative when shared with friends or posted for feedback. And it is generated using another fun tool called &lt;a href="https://stalefishlabs.com/experiments/transition-facts/" rel="noopener noreferrer"&gt;Transition Facts&lt;/a&gt;. Try it out!&lt;/p&gt;

&lt;h2&gt;
  
  
  What Was Learned
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Lumber math is surprisingly hard.&lt;/strong&gt; The gap between theoretical geometry and real-world lumber is where most ramp builds go wrong. You can calculate a perfect radius in a spreadsheet, but if you don't account for lumber length standards, sheet goods sizes, and realistic fastener quantities, you'll make three trips to the hardware store instead of one.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Exploded views teach better than assembly diagrams.&lt;/strong&gt; Static diagrams show you what a ramp looks like. Exploded views show you how it goes together. The slider interaction — dragging layers apart and watching them fan out — builds spatial understanding faster than any set of written instructions.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;PDF export matters more than expected.&lt;/strong&gt; I added PDF export as an afterthought. It turned out to be the most-requested feature in early testing. People want to take their ramp design to the lumber yard, and a phone-friendly PDF with the 3D view and materials list is exactly the format that works.&lt;/p&gt;

&lt;h2&gt;
  
  
  Try It
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/experiments/ramp-designer/"&gt;Ramp Designer&lt;/a&gt; runs entirely in your browser. No account, no install, no tracking. Choose quarterpipe or half pipe, set your dimensions, and start designing.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;The &lt;a href="https://dev.to/experiments/ramp-designer/"&gt;Ramp Designer&lt;/a&gt; is a free experiment from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>design</category>
      <category>showdev</category>
      <category>sideprojects</category>
      <category>watercooler</category>
    </item>
    <item>
      <title>The Group Chat Had It Right: Why I Un-Fixed Visible Picks</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Wed, 01 Apr 2026 05:00:37 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/the-group-chat-had-it-right-why-i-un-fixed-visible-picks-20d5</link>
      <guid>https://dev.to/stalefishlabs/the-group-chat-had-it-right-why-i-un-fixed-visible-picks-20d5</guid>
      <description>&lt;p&gt;In a &lt;a href="https://dev.to/the-lab/2026-03-06-from-group-chat-to-app/"&gt;previous article&lt;/a&gt;, I wrote about how moving our F1 fantasy game from a text thread to an app unlocked pick categories that were too tedious to score by hand. The Overtaker pick replaced Fastest Lap in the app, and made the game better by doing things the group chat couldn't.&lt;/p&gt;

&lt;p&gt;This article is about the opposite: a case where building the app made me &lt;em&gt;worse&lt;/em&gt; at game design, because I reflexively added a restriction that the group chat never needed. It was a lesson in not always doing things just because you can. &lt;/p&gt;

&lt;h2&gt;
  
  
  How it worked in the text thread
&lt;/h2&gt;

&lt;p&gt;Our original game was dead simple. A group of friends who enjoy watching Formula One making lightweight fantasy picks for each race. It was all managed in a text thread and in Notes on my phone. You texted your picks to the group before the race started. Everyone saw everyone's picks the moment they hit the chat. You could change your mind as many times as you wanted, right up until the formation lap. Nobody really tracked or enforced a hard deadline because the gentleman's agreement was enough.&lt;/p&gt;

&lt;p&gt;And here's the thing we mostly took for granted but everyone enjoyed: you could see what your rivals picked. If you were trailing in the standings and neck-and-neck with someone, you might deliberately wait to see what they picked, and then pick a different driver for the podium to create a scoring differential. If you were leading, you might mirror a rival's picks to protect your gap. It wasn't chess, but it was a real layer of strategy on top of "who do you think finishes on the podium."&lt;/p&gt;

&lt;p&gt;Yet during several years of playing this way, almost nobody actually changed their picks strategically after submitting. The option was always there, but people mostly picked and moved on. What I learned the hard way is the strategic value wasn't in last-second switching. It was in the &lt;em&gt;information&lt;/em&gt;: knowing what you were up against.&lt;/p&gt;

&lt;h2&gt;
  
  
  What I did when I built the app
&lt;/h2&gt;

&lt;p&gt;When I sat down to build Open Wheelers the app, I did what felt obvious: hide everyone's picks until they lock. Blind picks. You submit yours, you see a checkmark next to your leaguemates' names confirming they've picked, but you don't see &lt;em&gt;what&lt;/em&gt; they picked until the window closes and picks lock (the race start). Standard fantasy app behavior. The app suddenly gave me the power to enforce a new rule (blind picks), so why not do it?&lt;/p&gt;

&lt;p&gt;I didn't even really think about it too deeply. Every fantasy platform I'd ever used worked this way. Draft picks are secret. Lineup changes are private. Why would you show your poker hand a moment sooner than required? The whole model assumes that seeing someone else's choices gives you an unfair advantage, so the system prevents it. It's such a default assumption that I never questioned whether it was actually right for &lt;em&gt;this&lt;/em&gt; game. And this is even given the knowledge that I deliberately set out to build a contrarian fantasy game!&lt;/p&gt;

&lt;h2&gt;
  
  
  What I lost
&lt;/h2&gt;

&lt;p&gt;During initial testing of the appified game, something felt off. The picks phase was... quiet. You'd open the app, make your picks, close it, and wait. There was nothing to talk about until the race started and picks were revealed. The group text thread used to buzz with reactions to each other's picks. Hot takes. Trash talk. "Lewis is struggling with Ferrari but you just can't quit him, eh?" That energy was gone, replaced by a sterile, sealed-envelope experience.&lt;/p&gt;

&lt;p&gt;Worse, I'd killed the strategic layer entirely. You couldn't differentiate from a rival because you didn't know what they picked. You couldn't mirror someone to protect a lead because their picks were invisible. Every decision was made in a vacuum, which sounds fair but actually just makes the game shallower. Pure prediction skill is fine, but prediction skill plus situational awareness is more interesting. Indeed, sometimes ultimate fairness loses out to quality of life.&lt;/p&gt;

&lt;p&gt;The irony is that I'd written a whole article about how the app should unlock &lt;em&gt;more&lt;/em&gt; depth, not less. And here I was, having voluntarily removed a dimension of gameplay that the text thread gave us for free. Indeed, sometimes less is more.&lt;/p&gt;

&lt;h2&gt;
  
  
  The "because I could" trap
&lt;/h2&gt;

&lt;p&gt;This is the trap, and I think it's common in software: when you move something analog to digital, you inherit assumptions from existing digital products instead of examining what actually worked about the original. I looked at other fantasy apps and copied their pick visibility model without asking whether it fit our game. Which is admittedly funny because up to this point I literally looked at nothing else in fantasy F1 apps because I wanted Open Wheelers to be its own unique thing.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/ao3xru.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/ao3xru.jpg" title="\" alt="" width="800" height="400"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The group chat didn't hide picks because it was good game design, it literally &lt;em&gt;couldn't&lt;/em&gt;. Messages are visible to everyone. But that constraint turned out to be a feature. It created a social, strategic experience that I then engineered away because I had the power to build walls that a text thread couldn't.&lt;/p&gt;

&lt;p&gt;Sometimes "because I could" is the right answer. The Overtaker category exists because the app &lt;em&gt;can&lt;/em&gt; compute grid-to-finish deltas automatically. That's a genuine improvement, and the gains were felt immediately. But hiding picks? That was me solving a problem that didn't exist, importing a convention from games with different dynamics, and making the experience worse in the process. I went with effectively the software default when in reality the low-tech constraint was a winner all along.&lt;/p&gt;

&lt;h2&gt;
  
  
  What I changed
&lt;/h2&gt;

&lt;p&gt;The fix was almost embarrassingly simple. Picks are now visible to your leaguemates the moment they're submitted. You can still change yours freely until they lock at the start of the race, just like the text thread. No countdown timers, no change limits, no special mechanics. Just open information and the freedom to act on it.&lt;/p&gt;

&lt;p&gt;Will some people wait to see what others pick before committing? Maybe. Will there be occasional last-minute switches and skulduggery? Probably. But years of running the text thread game proved that this mostly doesn't happen, and when it does, it's &lt;em&gt;fun&lt;/em&gt;. It's a feature, not a bug. "Did you see that she switched her podium pick 30 seconds before lights out?" is exactly the kind of story a fantasy game should generate.&lt;/p&gt;

&lt;h2&gt;
  
  
  The design principle
&lt;/h2&gt;

&lt;p&gt;Last time, with the Overtaker change, the lesson was that the best mechanics are often the ones too complicated to run by hand. This time it's the complement: &lt;strong&gt;not every analog constraint is a problem to solve&lt;/strong&gt;. Some constraints are load-bearing walls disguised as limitations.&lt;/p&gt;

&lt;p&gt;When you're digitizing a game, or really any experience, the hard part isn't adding capabilities. It's knowing which rough edges to preserve. The text thread's visible picks felt like a limitation of the medium. They were actually a core part of the game.&lt;/p&gt;

&lt;p&gt;Build the features that were impossible before. But before you "fix" something that wasn't broken, go back and play the original. The group chat might know something you forgot. Box, box.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;&lt;a href="https://stalefishlabs.com/apps/openwheelers/" rel="noopener noreferrer"&gt;Open Wheelers&lt;/a&gt; is a casual F1 and IndyCar fantasy game for friends, built by &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>devjournal</category>
      <category>gamedev</category>
      <category>sideprojects</category>
      <category>ux</category>
    </item>
    <item>
      <title>Building Confidence Into Uncertain Verdicts</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Tue, 31 Mar 2026 19:31:40 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/building-confidence-into-uncertain-verdicts-l70</link>
      <guid>https://dev.to/stalefishlabs/building-confidence-into-uncertain-verdicts-l70</guid>
      <description>&lt;p&gt;This is the final article in the &lt;a href="https://dev.to/the-lab/2026-03-12-weather-engine-intro/"&gt;Building a Weather Decision Engine&lt;/a&gt; series. The previous articles covered the &lt;a href="https://dev.to/the-lab/2026-03-17-drying-model/"&gt;drying model&lt;/a&gt;, &lt;a href="https://dev.to/the-lab/2026-03-20-one-engine-three-apps/"&gt;multi-app architecture&lt;/a&gt;, &lt;a href="https://dev.to/the-lab/2026-03-23-edge-cases/"&gt;edge cases&lt;/a&gt;, and the &lt;a href="https://dev.to/the-lab/2026-03-25-flipping-the-question/"&gt;Yardwise inversion&lt;/a&gt;. This last one is about the output side, how the engine communicates decisions to people who just want to know if they should go ride.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why Not a Percentage?
&lt;/h2&gt;

&lt;p&gt;The first version of the engine returned a moisture percentage. Users hated it. To be honest I kinda hated it too but it was the first logical thing to represent as meaningful output.&lt;/p&gt;

&lt;p&gt;"Your trail is at 47% moisture" sounds precise. But what do you do with that? Is 47% rideable? It depends on the surface, your tolerance for mud, whether you care about trail damage, and how far you're willing to drive for a "maybe." The percentage outsources the decision to the user, which is the entire thing the app was supposed to handle. Besides, I have no idea what percentage tips me one way or the other toward making a real life ride decision.&lt;/p&gt;

&lt;p&gt;A percentage also implies false precision. The engine's moisture model is a reasonable approximation, not a soil sensor reading. Presenting a number with two significant digits suggests an accuracy that doesn't exist, so it's misleading. The difference between 47% and 49% is noise, not signal.&lt;/p&gt;

&lt;p&gt;Three states (&lt;strong&gt;Yes&lt;/strong&gt;, &lt;strong&gt;Maybe&lt;/strong&gt;, &lt;strong&gt;No&lt;/strong&gt;) work because they match how people actually think about the decision. You're either going (Yes), not going (No), or weighing it (Maybe). The engine's job is to put you in the right decision bucket, not to give you a homework problem.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Maybe State Is the Product
&lt;/h2&gt;

&lt;p&gt;The Yes and No verdicts are straightforward. The real design challenge is Maybe.&lt;/p&gt;

&lt;p&gt;Maybe exists for conditions where reasonable people would disagree. A wetness score of 0.4 on a dirt trail means it's damp but not muddy. Some riders would go. Others would wait. A veteran on a hardtail who likes playing the drift might like the extra challenge of some surprise slip here and there. A flowier rider on a full-suspension with less tire clearance might not want to bother and risk the occasional wet low spot. There's also some variance in trails opening and closing based on conditions, which is another facet of where local knowledge would tip a Maybe verdict one way or the other.&lt;/p&gt;

&lt;p&gt;The engine can't make that call for you. What it &lt;em&gt;can&lt;/em&gt; do is tell you &lt;strong&gt;why&lt;/strong&gt; conditions are borderline, so you can apply your own judgment.&lt;/p&gt;

&lt;h2&gt;
  
  
  Rationale: The Why Behind the Verdict
&lt;/h2&gt;

&lt;p&gt;Every assessment includes a structured rationale:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;struct&lt;/span&gt; &lt;span class="kt"&gt;GroundwiseRationale&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;headline&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;HeadlineReason&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;decisiveFactor&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;DecisiveFactor&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;headlineContext&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;HeadlineContext&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;details&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="kt"&gt;DetailReason&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;values&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RationaleValues&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;strong&gt;headline&lt;/strong&gt; is the one-line summary: "Light rain still drying" or "Strong drying clearing moisture" or "Frozen conditions — ice hazard." It's what the user reads first.&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;decisive factor&lt;/strong&gt; identifies the single most important reason for the verdict. This is the tie-breaker — the one variable that, if changed, would flip the result. "Recent heavy rain" or "weak drying conditions" or "surface sensitivity."&lt;/p&gt;

&lt;p&gt;The &lt;strong&gt;details&lt;/strong&gt; array provides up to six contributing factors, each describing how a specific weather element is affecting conditions, either positively or negatively. Temperature is helping. Humidity is slowing things down. Wind is moderate. These aren't ranked by importance, they're presented as a set of forces that the user can scan to build their own picture, with the verdict-supporting forces appearing first.&lt;/p&gt;

&lt;p&gt;The engine deliberately avoids showing the raw numbers in the rationale. Users don't need to know that drying strength is 0.53 or that the wetness score is 0.38. They need to know "drying conditions are moderate — warm but humid." The rationale translates numbers into plain language.&lt;/p&gt;

&lt;h2&gt;
  
  
  Confidence: Admitting What You Don't Know
&lt;/h2&gt;

&lt;p&gt;Each verdict has a confidence level — Low, Medium, or High. Don't forget that we're highly dependent on the weather source, and can't control the occasional hiccup where a piece of key data is missing. That's where Confidence enters the picture, and it starts at High and gets reduced by specific factors:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Missing timing data → Low confidence.&lt;/strong&gt; If the engine doesn't know when rain ended (the &lt;code&gt;minutesSinceRainEnded&lt;/code&gt; value is nil), it can't model the timing decay that's central to the wetness calculation. It defaults to a 0.5 timing score (assume moderate concern) and drops confidence to Low. The verdict might be right, but the engine is guessing about a critical input.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Patchy rain → Medium confidence.&lt;/strong&gt; When the weather source indicates precipitation has been spotty and inconsistent (&lt;code&gt;patchyRainLikely&lt;/code&gt;), the actual conditions at the user's spot might differ from what the nearest weather station recorded. The engine can't know whether the rain hit your trail or the parking lot a mile away. These are unknown unknowns, well maybe they're known unknowns...either way we don't know!&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Near-threshold conditions → Medium confidence.&lt;/strong&gt; If the wetness score lands within 0.05 of a verdict boundary (0.25-0.35 near the Yes/Maybe line, or 0.55-0.65 near the Maybe/No line), the engine reduces confidence because a small change in any input could flip the result. This is the engine saying "I'm calling it Maybe, but it could easily be Yes."&lt;/p&gt;

&lt;p&gt;The confidence level affects how the UI presents the verdict. A High-confidence No is "Don't ride — conditions are poor." A Low-confidence Maybe is "Conditions are uncertain — check conditions on the ground." Same verdict structure, different emphasis.&lt;/p&gt;

&lt;h3&gt;
  
  
  What I Didn't Do With Confidence
&lt;/h3&gt;

&lt;p&gt;I considered making confidence a continuous value (0-1) or adding more levels. I didn't, for the same reason I use three verdict states instead of a percentage: more granularity creates more decisions for the user without adding useful information. The whole point here is to simplify decision making.&lt;/p&gt;

&lt;p&gt;The three levels map to three communication strategies:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;High:&lt;/strong&gt; Trust the verdict&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Medium:&lt;/strong&gt; The verdict is our best call, but conditions might surprise you&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Low:&lt;/strong&gt; We're short on data, verify on the ground&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That's enough to calibrate expectations without overwhelming.&lt;/p&gt;

&lt;h2&gt;
  
  
  Recovery Outlook: "So When Will It Be Good?"
&lt;/h2&gt;

&lt;p&gt;The natural follow-up to a No or Maybe verdict is "when will conditions improve?" I was initially skeptical about including this but it has turned out to be extremely valuable because as is often the case, I'm actually not looking at the app to ride right this moment, I'm typically planning ahead for "later today." The engine provides a recovery outlook, a qualitative time estimate, to attempt to answer.&lt;/p&gt;

&lt;p&gt;The outlook is a simple 2D lookup: wetness score vs. drying strength.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Wetness / Drying&lt;/th&gt;
&lt;th&gt;Strong&lt;/th&gt;
&lt;th&gt;Moderate&lt;/th&gt;
&lt;th&gt;Weak&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Low (&amp;lt; 0.4)&lt;/td&gt;
&lt;td&gt;Within hours&lt;/td&gt;
&lt;td&gt;A few hours&lt;/td&gt;
&lt;td&gt;Maybe later today&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Medium (0.4-0.6)&lt;/td&gt;
&lt;td&gt;A few hours&lt;/td&gt;
&lt;td&gt;Later today&lt;/td&gt;
&lt;td&gt;Maybe later today&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;High (≥ 0.6)&lt;/td&gt;
&lt;td&gt;Later today&lt;/td&gt;
&lt;td&gt;Maybe later today&lt;/td&gt;
&lt;td&gt;Unlikely today&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The categories are deliberately vague. "Within hours" means 1-2 hours. "Later today" means afternoon or evening. "Unlikely today" means tomorrow at the earliest. The engine doesn't say "rideable at 2:47 PM" because that precision doesn't exist in the model and it would be ridiculous to pretend that level of accuracy.&lt;/p&gt;

&lt;p&gt;The "maybe later today" bucket is the uncertainty hedge — conditions might improve, but the engine isn't confident enough to commit. It's the recovery equivalent of the Maybe verdict.&lt;/p&gt;

&lt;p&gt;There's also a "may worsen" outlook for cases where the forecast indicates more precipitation. If the next few hours include rain, the engine won't tell you things are improving, even if current drying conditions are strong. This prevents the frustrating experience of waiting for conditions to improve only to get rained on again. And this is fairly common on days where I'm pretty sure the trail is day right now but less sure of how the afternoon is going to go. In this regard, the engine isn't just a past weather + surface conditions evaluator, it's also taking a peek into the future (forecast) to give you a sense of if things are trending better, worse, or more of the same.&lt;/p&gt;

&lt;h2&gt;
  
  
  Risk Categories: More Than Just "Wet"
&lt;/h2&gt;

&lt;p&gt;It occurred to me fairly quickly when building Ridewise that what we're dealing with here isn't just the ability to ride, as in muddy or not muddy, but also the risk implications. I'm using risk here as a two-way term depending on activity: risk to the user and in some cases risk to the surface. For a concrete skatepark, it's entirely user risk, but for a mountain bike trail or sod soccer field, it's risk to the surface. Actually the mountain bike example might cut both ways but you get the idea. And there's the quality of the activity that I decided was also effectively a risk. So beyond the binary wet/dry question, the engine evaluates three distinct risk categories:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Surface damage&lt;/strong&gt; — Will using this surface in current conditions cause lasting harm? This matters most for natural grass athletic fields (0.9 sensitivity), newly seeded lawns (up to 1.0 with establishment boost), and clay courts (0.85). It matters least for artificial turf (0.05), metal (0.05), and compost (0.3).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Activity safety&lt;/strong&gt; — Is the surface dangerous to use? Wet metal has the highest safety sensitivity (0.95) because it becomes extremely slippery. Composite ramp surfaces like Skatelite and Ramp Armor are also high (0.85), along with metal and concrete. Artificial turf and potting mix are low (0.4) because their textures maintain grip even when wet. Indeed nobody skates on potting mix, but this illustrates how one engine can serve three different apps if you're very careful about the design.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Activity quality&lt;/strong&gt; — Even if it's safe, will the experience be poor? Mud on a dirt trail (0.7 quality sensitivity) makes for a miserable ride. A damp skatepark (0.6) is more debatable, and can range from totally fine (squeegee the ramp and it may dry out) to a complete no-go.&lt;/p&gt;

&lt;p&gt;These three risks are calculated independently and presented alongside the verdict. A Maybe verdict might come with low safety risk but high damage risk — meaning "you'd be fine riding, but you'd rut up the trail." That distinction helps the user make an informed call.&lt;/p&gt;

&lt;h2&gt;
  
  
  Putting It All Together
&lt;/h2&gt;

&lt;p&gt;The full assessment output:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;struct&lt;/span&gt; &lt;span class="kt"&gt;GroundwiseAssessment&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;verdict&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Verdict&lt;/span&gt;              &lt;span class="c1"&gt;// Yes / Maybe / No&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;confidence&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Confidence&lt;/span&gt;        &lt;span class="c1"&gt;// Low / Medium / High&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rationale&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;GroundwiseRationale&lt;/span&gt; &lt;span class="c1"&gt;// Why&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;riskSurfaceDamage&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RiskLevel&lt;/span&gt;  &lt;span class="c1"&gt;// Harm to surface&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;riskActivitySafety&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RiskLevel&lt;/span&gt; &lt;span class="c1"&gt;// Danger to user&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;riskActivityQuality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RiskLevel&lt;/span&gt;&lt;span class="c1"&gt;// Experience quality&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;recoveryOutlook&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RecoveryOutlook&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt; &lt;span class="c1"&gt;// When will it improve&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The verdict is the headline. Confidence tells you how much to trust it. The rationale explains why. Risk levels add nuance. Recovery outlook answers "when?"&lt;/p&gt;

&lt;p&gt;None of these fields exist in isolation. Together, they give the user a complete picture in a few seconds of scanning — enough information to make a confident decision without reading a weather report.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Design Principle
&lt;/h2&gt;

&lt;p&gt;The engine's output design follows one principle: &lt;strong&gt;make the decision for the user, then show your work.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Most users will see the verdict color, read the headline, and decide. That's the 80% case, and it should take three seconds. The rationale, risk levels, and recovery outlook are there for the 20% who want to understand why, or who are in a borderline situation where the details matter. And yes, I want wildly overboard on the proving your work part because I wanted it to be crystal clear that this isn't a pretty veneer over what is essentially a weather app — the Groundwise engine is doing sophisticated modeling in service of a "simple" yet nuanced and challenging question about rideability/playability/vulnerability (plant vulnerability in Yardwise).&lt;/p&gt;

&lt;p&gt;This is the opposite of how most weather apps work. They give you all the data and expect you to synthesize it into a decision. The Groundwise engine synthesizes first, then offers the data for verification. The user's default is to trust the verdict and act on it. The detail is available but not required.&lt;/p&gt;

&lt;p&gt;That's what made three states better than a percentage. A percentage demands interpretation. A verdict offers a recommendation. The supporting detail is opt-in, not mandatory.&lt;/p&gt;

&lt;h2&gt;
  
  
  Thanks for Reading
&lt;/h2&gt;

&lt;p&gt;This series covered a lot of ground, from the &lt;a href="https://dev.to/the-lab/2026-03-12-weather-engine-intro/"&gt;core concept&lt;/a&gt; through the &lt;a href="https://dev.to/the-lab/2026-03-17-drying-model/"&gt;drying math&lt;/a&gt;, &lt;a href="https://dev.to/the-lab/2026-03-20-one-engine-three-apps/"&gt;multi-app architecture&lt;/a&gt;, &lt;a href="https://dev.to/the-lab/2026-03-23-edge-cases/"&gt;winter edge cases&lt;/a&gt;, &lt;a href="https://dev.to/the-lab/2026-03-25-flipping-the-question/"&gt;the Yardwise inversion&lt;/a&gt;, and now the verdict UX. If you've built something that turns noisy data into human decisions, I'd love to hear about your approach. The threshold and confidence problems are universal.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;The Groundwise engine powers &lt;a href="https://stalefishlabs.com/apps/ridewise/" rel="noopener noreferrer"&gt;Ridewise&lt;/a&gt;, &lt;a href="https://stalefishlabs.com/apps/fieldwise/" rel="noopener noreferrer"&gt;Fieldwise&lt;/a&gt;, and &lt;a href="https://stalefishlabs.com/apps/yardwise/" rel="noopener noreferrer"&gt;Yardwise&lt;/a&gt; — all available for iOS from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;. Find us on &lt;a href="https://bsky.app/profile/stalefishlabs.bsky.social" rel="noopener noreferrer"&gt;Bluesky&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>softwaredevelopment</category>
      <category>systemdesign</category>
      <category>ui</category>
      <category>ux</category>
    </item>
    <item>
      <title>Flipping the Question: From 'Is It Too Wet?' to 'Is It Too Dry?'</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Fri, 27 Mar 2026 16:30:24 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/flipping-the-question-from-is-it-too-wet-to-is-it-too-dry-471d</link>
      <guid>https://dev.to/stalefishlabs/flipping-the-question-from-is-it-too-wet-to-is-it-too-dry-471d</guid>
      <description>&lt;p&gt;When I first built the Groundwise engine for the &lt;a href="https://dev.to/apps/ridewise/"&gt;Ridewise app&lt;/a&gt;, it answered one question: &lt;strong&gt;is it too wet to ride?&lt;/strong&gt; Low wetness meant good conditions. High wetness meant stay home. Exactly what I needed for mountain biking, skateboarding, and other outdoor wheeled activities where surface conditions impacted by weather mattered.&lt;/p&gt;

&lt;p&gt;Then I started thinking about my garden.&lt;/p&gt;

&lt;p&gt;I have raised beds, a few containers on the patio, and a lawn that I'd like to keep alive without drowning it. I don't get obsessive about it, and to be honest my lawn is far from impressive. I'm not one of those people who try to maintain golf course grass, far from it. But I've still regularly done that assessment where I look at the sky, vaguely remember whether it rained, and make the same kind of gut call on watering that I used to make about trails. The variables were familiar: recent rain, temperature, sun exposure, how fast things dry. I was running the same mental model, just asking the opposite question.&lt;/p&gt;

&lt;p&gt;That realization is what turned one app into three. If the engine could quantify moisture on a surface, it could answer both "is it too wet to ride?" and "is it too dry, should I water?"&lt;/p&gt;

&lt;h2&gt;
  
  
  The Inversion
&lt;/h2&gt;

&lt;p&gt;The engine always calculates a wetness score from 0 (bone dry) to 1 (saturated). The &lt;code&gt;EngineMode&lt;/code&gt; enum controls what that score means:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Wetness concern&lt;/strong&gt; (Ridewise, Fieldwise): Low wetness = Yes (go ride or play). High wetness = No (too wet).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Dryness concern&lt;/strong&gt; (Yardwise): Low wetness = Yes (water today). High wetness = No (skip watering).&lt;/p&gt;

&lt;p&gt;The verdict is the same enum, &lt;code&gt;Yes&lt;/code&gt;, &lt;code&gt;Maybe&lt;/code&gt;, &lt;code&gt;No&lt;/code&gt;, but the interpretation flips. This means the consuming app doesn't need to know which mode produced the result. It renders green for Yes, orange for Maybe, red for No, regardless.&lt;/p&gt;

&lt;p&gt;The thresholds shift too:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Yes&lt;/th&gt;
&lt;th&gt;Maybe&lt;/th&gt;
&lt;th&gt;No&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Wetness concern&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&amp;lt; 0.30&lt;/td&gt;
&lt;td&gt;0.30 – 0.60&lt;/td&gt;
&lt;td&gt;≥ 0.60&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Dryness concern&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&amp;lt; 0.15&lt;/td&gt;
&lt;td&gt;0.15 – 0.45&lt;/td&gt;
&lt;td&gt;≥ 0.45&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Yardwise thresholds are lower because the stakes are asymmetric. This wasn't immediately obvious until testing early versions of the app, when I realized that missing a watering day rarely if ever harms established plants. Riding a muddy trail damages the surface. So Yardwise is more lenient than the other apps, and leans toward "maybe check the soil" rather than "definitely water" — this makes the verdict less alarming. The reality is that the cost of a false positive (unnecessary watering) is real (overwatering causes its own problems), while the cost of a false negative (skipping one day) is usually trivial.&lt;/p&gt;

&lt;h2&gt;
  
  
  Manual Watering: Tracking What the Weather Doesn't Know
&lt;/h2&gt;

&lt;p&gt;Here's where Yardwise diverges from Ridewise and Fieldwise most sharply. The weather API knows about rain. It doesn't know that you ran the sprinkler for 20 minutes yesterday evening.&lt;/p&gt;

&lt;p&gt;Yardwise lets users log manual watering events with timestamps. The engine converts these into precipitation equivalents that then get added to the rain score alongside actual precipitation, with the same time-weighted decay:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;0-24 hours ago:  0.7x weight (70% contribution)
24-48 hours ago: 0.2x weight
48-72 hours ago: 0.1x weight
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A watering yesterday contributes about 0.175 inches to the effective precipitation (0.25 × 0.7). That's enough to shift a borderline "water today" verdict to "check soil" or even "skip."&lt;/p&gt;

&lt;p&gt;The decay is important. A watering three days ago shouldn't prevent the engine from recommending water today, the moisture is long gone, especially in containers with fast-draining potting mix. The time-weighted model handles this naturally.&lt;/p&gt;

&lt;h3&gt;
  
  
  Cold Weather Extends Watering Memory
&lt;/h3&gt;

&lt;p&gt;One wrinkle: cold weather slows evapotranspiration. A watering event that would normally decay in 48 hours can remain relevant for up to 96 hours during cold weather. The engine extends the effective window based on the same cold factor used for dormancy:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;wateringWindow&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;48&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;48&lt;/span&gt; &lt;span class="err"&gt;×&lt;/span&gt; &lt;span class="nx"&gt;coldFactor&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;At 34°F, the cold factor is about 0.62, giving a window of roughly 78 hours. At 45°F, it's about 56 hours. This prevents the engine from recommending watering when yesterday's water is still sitting in cold, slowly-evaporating soil. Keep in mind that winter watering is pretty rare, reserved almost exclusively for new plantings (trees, shrubs, etc.) and only during an unusual dry spell.&lt;/p&gt;

&lt;h2&gt;
  
  
  Establishment Sensitivity: Protecting Young Plants
&lt;/h2&gt;

&lt;p&gt;Newly seeded lawns and recently transplanted plants need more water than established ones, and they're far more susceptible to drought. The engine handles this through an establishment sensitivity boost that layers on top of the surface type's base damage sensitivity.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Establishment&lt;/th&gt;
&lt;th&gt;Sensitivity Boost&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Established&lt;/td&gt;
&lt;td&gt;+0.0 (default)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Newly planted&lt;/td&gt;
&lt;td&gt;+0.2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Newly seeded&lt;/td&gt;
&lt;td&gt;+0.5&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;This boost affects the sensitivity veto, the mechanism that pushes borderline verdicts toward protection. With a newly seeded lawn (base sensitivity 0.4 + boost 0.5 = 0.9 effective sensitivity), a Maybe verdict with wetness below 0.3 gets overridden to Yes: water those seeds.&lt;/p&gt;

&lt;p&gt;For established plants with no boost, the same borderline conditions stay as Maybe: check the soil yourself. The engine doesn't push you to water unless there's a fragile surface that genuinely needs protection.&lt;/p&gt;

&lt;p&gt;This is the same sensitivity veto that Fieldwise uses to protect natural grass athletic fields from being played on when borderline wet. Same mechanism, opposite direction. In wetness-concern mode, high sensitivity + borderline conditions → No (protect from use). In dryness-concern mode, high sensitivity + borderline conditions → Yes (protect from drought).&lt;/p&gt;

&lt;h2&gt;
  
  
  Dormancy and Evaporative Demand
&lt;/h2&gt;

&lt;p&gt;Two Yardwise-specific wetness modifiers that were covered in the &lt;a href="https://dev.to/the-lab/2026-03-23-edge-cases/"&gt;edge cases article&lt;/a&gt; deserve a brief recap in the context of the inversion:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Cold-weather dormancy&lt;/strong&gt; injects additional wetness into the score when temperatures drop below 55°F. This suppresses watering recommendations by pushing the score toward the "skip" zone because dormant plants don't benefit from watering and the moisture promotes root rot and fungal growth.&lt;/p&gt;

&lt;p&gt;From the engine's perspective, dormancy is saying: "the soil might technically be dry, but the plant doesn't need water right now, so act as if conditions are wetter than they are."&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Low evaporative demand&lt;/strong&gt; does something similar on cool, overcast, humid days. Even if the soil surface looks dry, the plant isn't losing much water through transpiration when there's no sun and the air is already saturated. A small wetness boost (up to 0.25) prevents unnecessary watering recommendations.&lt;/p&gt;

&lt;p&gt;Both modifiers only activate in dryness-concern mode. They don't make sense for riders or field sports, cold weather doesn't make a trail less muddy, and overcast skies don't affect whether the ground is rideable or a football field is playable.&lt;/p&gt;

&lt;h2&gt;
  
  
  Yardwise Surface Types
&lt;/h2&gt;

&lt;p&gt;The Groundwise family shares a surface type system, but Yardwise introduces types that don't exist in the riding or sports world:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Potting mix&lt;/strong&gt; (containers) dries at 2.0x — the same rate as concrete. This isn't a coincidence. Potting mix is engineered for drainage, just like concrete. Containers are also typically exposed to wind on all sides, which accelerates drying considerably. The result: containers often need daily watering in summer, even after rain. The engine captures this naturally because the high drying multiplier clears moisture quickly.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Amended soil with mulch&lt;/strong&gt; dries at 0.7x — the slowest rate in the system, tied with clay. Mulch deliberately slows evaporation. A mulched garden bed after rain stays moist for days. The engine's residual wetness model (which only activates for absorbent surfaces above 0.25 inches of rain) extends this further, keeping the score in "skip watering" territory well after a good rain.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Fresh seed&lt;/strong&gt; has the highest effective damage sensitivity in the system: base 0.8 plus an establishment boost of 0.5, capped at 1.0. The engine is maximally protective of newly seeded areas, pushing any borderline verdict toward "water."&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Compost&lt;/strong&gt; is the most forgiving surface: 1.2x drying multiplier and only 0.3 damage sensitivity. Compost generates internal heat from decomposition, which drives some of its own drying. And it's hard to damage, overwatering a compost pile isn't really a concern. The engine mostly stays out of the way for compost, skewing toward "skip" unless conditions are genuinely dry.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Insight That Made It Work
&lt;/h2&gt;

&lt;p&gt;The hardest part of building Yardwise wasn't the code, it was convincing myself that the inversion was valid. Every instinct I'd built while developing Ridewise and Fieldwise said "wet = bad." Retraining my thinking to "wet = good (for gardening)" took effort.&lt;/p&gt;

&lt;p&gt;What made it click was realizing that the engine isn't really about wet or dry. It's about &lt;strong&gt;moisture state relative to the ideal for a given surface and activity.&lt;/strong&gt; For a trail, the ideal is dry. For a garden bed, the ideal is moist (not soaked!). The engine measures distance from ideal in both directions.&lt;/p&gt;

&lt;p&gt;Once I saw it that way, the inversion was mechanical. Same measurements, same model, same pipeline. Just a different definition of "good."&lt;/p&gt;

&lt;h2&gt;
  
  
  Next in the Series
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/the-lab/2026-03-27-uncertain-verdicts/"&gt;final article&lt;/a&gt; covers the verdict UX, why three states beat a percentage, how the engine communicates uncertainty through confidence levels and contributing factors, and the role of the recovery outlook in managing expectations.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;&lt;a href="https://stalefishlabs.com/apps/yardwise/" rel="noopener noreferrer"&gt;Yardwise&lt;/a&gt; is available for iOS from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;. Same engine as &lt;a href="https://stalefishlabs.com/apps/ridewise/" rel="noopener noreferrer"&gt;Ridewise&lt;/a&gt; and &lt;a href="https://stalefishlabs.com/apps/fieldwise/" rel="noopener noreferrer"&gt;Fieldwise&lt;/a&gt;, different question.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>devjournal</category>
      <category>mobile</category>
      <category>showdev</category>
      <category>sideprojects</category>
    </item>
    <item>
      <title>Edge Cases That Break Your Weather Model</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Mon, 23 Mar 2026 18:31:28 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/edge-cases-that-break-your-weather-model-2j1f</link>
      <guid>https://dev.to/stalefishlabs/edge-cases-that-break-your-weather-model-2j1f</guid>
      <description>&lt;p&gt;This is a continuation of a deep-dive into the weather engine that drives our Groundwise apps. Last we looked into the core &lt;a href="https://dev.to/the-lab/2026-03-17-drying-model/"&gt;drying model&lt;/a&gt;, which handles most days well. Sun, wind, time, surface type — combine them sensibly and you get a reasonable verdict most of the time.&lt;/p&gt;

&lt;p&gt;Then winter arrives and everything breaks. Interestingly, the engine was developed during the epic ice storm of 2026 that absolutely decimated parts of the southeastern U.S., including Nashville, TN where we're based. So I got to experience first-hand a very real edge case as I was building the engine, and literally each day presented new challenges to clarify for example how long it actually takes a trail to recover from a prolonged frozen period.&lt;/p&gt;

&lt;p&gt;This article covers the edge cases that forced the most complex logic in the Groundwise engine, the scenarios where the simple model produces confidently wrong answers.&lt;/p&gt;

&lt;h2&gt;
  
  
  Freeze/Thaw: 360 Lines of Humility
&lt;/h2&gt;

&lt;p&gt;The frozen conditions check is the single largest block of code in the engine. It runs first, before any moisture modeling, because frozen ground is a fundamentally different hazard than wet ground.&lt;/p&gt;

&lt;p&gt;The naive approach would be simple: if the temperature is below 32°F, say No. But that misses almost everything that matters.&lt;/p&gt;

&lt;h3&gt;
  
  
  Hard Surfaces vs. Ground: Different Failure Modes
&lt;/h3&gt;

&lt;p&gt;A frozen concrete skatepark and a frozen dirt trail are dangerous for completely different reasons, and they recover at completely different speeds.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Concrete and asphalt&lt;/strong&gt; develop ice when moisture freezes on the surface. It's a thin layer — dangerous because it's invisible, but it clears relatively quickly once temperatures rise. At 55°F, a frozen skatepark is typically safe within 6 hours. At 50°F, give it 12. At 45°F, 24 hours, or just wait until 3 days after the last rain when there's simply no moisture left to freeze.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Dirt and natural grass&lt;/strong&gt; hold moisture internally. When they freeze, the ice is &lt;em&gt;in&lt;/em&gt; the ground, not just on top of it. Thawing releases that moisture all at once, creating a slurry that's worse than the original wet conditions. A ground trail at 45°F needs 72 hours to fully recover from a freeze — not because ice persists that long, but because the thaw creates its own wetness event. It's worth noting that one thing the engine does not attempt to factor in is the counterintuitive scenario where frozen mountain bike trails are sometimes &lt;em&gt;more&lt;/em&gt; rideable when fully frozen due to the combo of frost heave breaking up the surface tread and then a deep freeze solidifying that oatmeal-like top layer into a grippy crunch. If you bundle up, some of the best winter riding here is when a trail fully heaves and freezes, but that seemed like a special enough case to not factor in (at least not yet!), especially when you factor in ride comfort.  &lt;/p&gt;

&lt;p&gt;The engine models the concrete/asphalt vs. dirt/grass freeze issue with separate escape conditions for draining vs. absorbent surfaces:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Temperature&lt;/th&gt;
&lt;th&gt;Hard Surface Recovery&lt;/th&gt;
&lt;th&gt;Ground Recovery&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;≥ 55°F&lt;/td&gt;
&lt;td&gt;6 hours&lt;/td&gt;
&lt;td&gt;24 hours&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;≥ 50°F&lt;/td&gt;
&lt;td&gt;12 hours&lt;/td&gt;
&lt;td&gt;48 hours&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;≥ 45°F&lt;/td&gt;
&lt;td&gt;24 hours (or 3+ days since rain)&lt;/td&gt;
&lt;td&gt;72 hours&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&amp;lt; 45°F&lt;/td&gt;
&lt;td&gt;Still frozen&lt;/td&gt;
&lt;td&gt;Still frozen&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  The Near-Freezing Zone
&lt;/h3&gt;

&lt;p&gt;32°F isn't a magic line. Ice can persist on surfaces at 34°F, especially in shade. And moisture can pose a freeze risk at 38°F if temperatures are dropping. Throw in wind and it's pretty evident that a simple 32°F freeze check isn't sufficient.&lt;/p&gt;

&lt;p&gt;The engine treats 32-38°F as a caution zone. If there's been recent precipitation (last 24 hours) and the temperature is in this range, the verdict is No with medium confidence. Not because ice is definitely present, but because the risk isn't worth it.&lt;/p&gt;

&lt;h3&gt;
  
  
  Overnight Freeze, Currently Above Freezing
&lt;/h3&gt;

&lt;p&gt;This is the most common winter scenario and the hardest to get right, especially in a moderate climate like the southeast where it can freeze overnight and then rise to sunny and 50s during the day. So an overnight freeze that changes to 52°F mid-day...is the trail rideable?&lt;/p&gt;

&lt;p&gt;It depends on:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;How long it's been above freezing&lt;/strong&gt; — just crossed 32°F an hour ago? Still frozen. Been above freezing since 9am and it's now 2pm? Probably thawed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;What surface you're on&lt;/strong&gt; — concrete sheds faster than dirt.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Whether there's recent precipitation&lt;/strong&gt; — dry freeze is different from wet freeze.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Humidity&lt;/strong&gt; — above 70% humidity with a recent overnight freeze means possible frost even on surfaces that look dry.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The engine tracks &lt;code&gt;hoursBelowFreezing&lt;/code&gt; and &lt;code&gt;hoursSinceThawBegan&lt;/code&gt; to model this progression. A surface that was frozen for 48 hours takes longer to fully thaw than one that dipped below freezing for 4 hours overnight.&lt;/p&gt;

&lt;h3&gt;
  
  
  Extended Freeze With No Recent Rain
&lt;/h3&gt;

&lt;p&gt;It gets even trickier when you remove precipitation for a while. Here's a counterintuitive case: it's been below freezing for three days, but it hasn't rained or snowed in a week. Is it safe?&lt;/p&gt;

&lt;p&gt;For &lt;strong&gt;hard surfaces&lt;/strong&gt;: probably yes. No moisture means nothing to freeze. The engine still checks humidity (frost can form from humid air alone), but without recent precipitation, hard surfaces are likely clear.&lt;/p&gt;

&lt;p&gt;For &lt;strong&gt;ground surfaces&lt;/strong&gt;: still no. Even without recent rain, ground retains moisture from weeks of accumulated precipitation. A multi-day freeze locks that moisture in. When thaw comes, it releases.&lt;/p&gt;

&lt;h2&gt;
  
  
  Snow Melt: A Bell Curve, Not a Line
&lt;/h2&gt;

&lt;p&gt;Snow melt seems simple — snow melts, things get wet, then they dry. But the wetness injection from melting snow follows a curve that's nothing like the linear decay used for rain timing.&lt;/p&gt;

&lt;p&gt;The engine models thaw wetness on a bell curve based on melt progress:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Melt Progress&lt;/th&gt;
&lt;th&gt;Wetness Factor&lt;/th&gt;
&lt;th&gt;Why&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&amp;lt; 5%&lt;/td&gt;
&lt;td&gt;0.7 → 1.0&lt;/td&gt;
&lt;td&gt;Starting to melt, moisture building&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5-40%&lt;/td&gt;
&lt;td&gt;1.0&lt;/td&gt;
&lt;td&gt;Peak wetness, active melt, ground saturated&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;40-70%&lt;/td&gt;
&lt;td&gt;1.0 → 0.4&lt;/td&gt;
&lt;td&gt;Most snow gone, drainage beginning&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;70%+&lt;/td&gt;
&lt;td&gt;0.4 → 0.2&lt;/td&gt;
&lt;td&gt;Residual moisture, mostly clear&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Melt progress is estimated from hours since thaw began, with the assumption that most accumulations take about 48 hours to fully melt. Temperature above freezing drives the rate, warmer means faster.&lt;/p&gt;

&lt;p&gt;The peak wetness window (5-40% melted) is deliberately wide. During active melt, the ground is receiving a continuous supply of water. Unlike rain, which dumps water and stops, snow melt is a slow, sustained event that can keep surfaces saturated for hours.&lt;/p&gt;

&lt;p&gt;Snow accumulation matters too. Did you know that on average, 10 inches of snow is equivalent to 1 inch of liquid rain (a 10:1 ratio). However, this ratio varies significantly based on temperature, ranging from 5 inches (wet snow) to over 20 inches (dry, powdery snow) of snow for every 1 inch of liquid. But what we really care about is how much snow results in complete saturation. Here's how the engine scales the initial wetness injection for snow:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;snowFactor&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;clamp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;0.5&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;snowAccumulation&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mf"&gt;4.0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Half an inch gives a snowFactor of 0.625. Four inches saturates at 1.0. This prevents a light dusting from being treated the same as a significant snowfall.&lt;/p&gt;

&lt;h3&gt;
  
  
  When There's No Tracked Snow
&lt;/h3&gt;

&lt;p&gt;Sometimes the engine knows there was a freeze/thaw cycle but doesn't have explicit snow accumulation data. In that case, it falls back to estimating initial moisture from freeze severity:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;initialMoisture = 0.3 + 0.3 × freezeSeverity
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Where freeze severity scales from 0.3 (24 hours below freezing) to 0.6 (4+ days below freezing). Longer freezes lock more ground moisture, producing more wetness when thaw arrives.&lt;/p&gt;

&lt;p&gt;The decay uses a half-life model, a baseline of 48 hours, stretched dramatically when overnight temperatures keep dropping below freezing. A thaw that refreezes each night can keep surfaces problematic for over a week, because each night arrests the drying process and each morning restarts the moisture release.&lt;/p&gt;

&lt;h2&gt;
  
  
  Precipitation Intensity: Same Amount, Different Impact
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/the-lab/2026-03-17-drying-model/"&gt;drying model article&lt;/a&gt; covered the rain pattern multiplier (0.7x for light, 1.1x for steady, 1.5x for downpour), but intensity creates edge cases beyond just the multiplier.&lt;/p&gt;

&lt;p&gt;A quarter inch of light rain over four hours &lt;strong&gt;soaks into absorbent surfaces gradually&lt;/strong&gt;. The ground absorbs it progressively, and drainage keeps up. Surface water is minimal. This is the kind of rain you hear gardeners, landscapers, and farmers wishing for as it's the best watering rain for plants, slow and steady.&lt;/p&gt;

&lt;p&gt;A quarter inch dumped in 20 minutes, on the other hand, &lt;strong&gt;overwhelms drainage&lt;/strong&gt;. Water pools on the surface, runs off trails causing erosion, and saturates the top layer before it can percolate down. The surface is wetter even though the total precipitation is identical.&lt;/p&gt;

&lt;p&gt;The 1.5x downpour multiplier captures this, but it's an approximation. In reality, the impact depends heavily on the surface's infiltration rate, slope, and drainage design — none of which the engine models directly. And it doesn't try.&lt;/p&gt;

&lt;p&gt;This is one of the spots where the engine's approximation is "good enough for most cases" rather than trying to be physically accurate to the extreme. A purpose-built trail with water bars and crowned surfaces handles a downpour better than a flat trail in a natural depression. The engine treats both as dirt with a 1.0x drying multiplier, which is imprecise but still more useful than ignoring intensity entirely. This is also worth flagging where often a Maybe verdict is truly the best answer because it tells you conditions are borderline, and your own local knowledge may tip the final ride decision. Yes, the app is attempting to assist in the human intuition of weather conditions, but not replace it entirely.  &lt;/p&gt;

&lt;h2&gt;
  
  
  Cold-Weather Dormancy: Protecting Plants From Themselves
&lt;/h2&gt;

&lt;p&gt;This edge case is Yardwise-specific, but it's one of my favorites because it's a case where the "right" answer is counterintuitive.&lt;/p&gt;

&lt;p&gt;When temperatures drop below 55°F, most plants enter dormancy. Their water uptake drops dramatically. Watering dormant plants typically doesn't help them, it can all too easily create conditions for root rot and fungal disease. In this scenario the engine needs to &lt;strong&gt;suppress watering recommendations&lt;/strong&gt; even when the soil looks dry.&lt;/p&gt;

&lt;p&gt;The dormancy calculation uses a non-linear curve:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;coldFactor&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;pow&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="mi"&gt;55&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;temperature&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;23&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;0.6&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Why &lt;code&gt;pow(x, 0.6)&lt;/code&gt; instead of linear? Because the suppression should be strong even at moderate cold. At 45°F (10 degrees below the 55°F threshold), a linear model gives a cold factor of 0.43. The power curve gives 0.56, which is meaningfully stronger. The difference matters because 45°F is genuinely cold enough to suppress plant activity, and the engine should reflect that.&lt;/p&gt;

&lt;p&gt;The dormancy score gets amplified by:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Freeze history&lt;/strong&gt; — if it's been below 32°F for 24+ hours recently, plants are deeply dormant. Add 0.25 × coldFactor.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Recent cold-weather watering&lt;/strong&gt; — if the user watered during cold weather, that water persists much longer because evapotranspiration is minimal. The residual window extends from 48 hours to up to 96 hours. And yes, evapotranspiration is a real word...I couldn't resist using it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;But there's a warm-day dampener too. If the daytime high reaches 65°F even though it's cold right now, the suppression eases. This handles the classic spring pattern: cold mornings, warm afternoons. Plants &lt;em&gt;are&lt;/em&gt; still somewhat active on those warm afternoon hours, and a warm day drives real evaporation.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;warmDampening&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;clamp&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;warmerTemp&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mi"&gt;65&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;30&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mf"&gt;0.5&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nx"&gt;dormancyMoisture&lt;/span&gt; &lt;span class="o"&gt;*=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mf"&gt;1.0&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="nx"&gt;warmDampening&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;At 80°F daytime highs, the dampening cuts dormancy suppression in half. At 95°F, it's fully halved. The cold mornings still matter, but the warm afternoons are doing real drying work.&lt;/p&gt;

&lt;h2&gt;
  
  
  Low Evaporative Demand: When Dry Isn't Thirsty
&lt;/h2&gt;

&lt;p&gt;Another Yardwise-specific edge case: on overcast, humid days with moderate temperatures, the soil might technically be "dry" by the engine's moisture model, but the plants aren't actually losing much water because evaporative demand is low.&lt;/p&gt;

&lt;p&gt;Cloudy skies reduce solar radiation. High humidity reduces the vapor pressure gradient that drives transpiration. If both conditions are present and the temperature is under 85°F, the engine injects a small wetness boost (up to 0.25) to push borderline "water today" verdicts toward "check soil" or "skip."&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nx"&gt;cloudFactor&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;clamp&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;cloudCover&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mf"&gt;0.3&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mf"&gt;0.7&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nx"&gt;humidityFactor&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;clamp&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;humidity&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="mf"&gt;0.4&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mf"&gt;0.5&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nx"&gt;demandReduction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;cloudFactor&lt;/span&gt; &lt;span class="err"&gt;×&lt;/span&gt; &lt;span class="mf"&gt;0.55&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;humidityFactor&lt;/span&gt; &lt;span class="err"&gt;×&lt;/span&gt; &lt;span class="mf"&gt;0.45&lt;/span&gt;
&lt;span class="nx"&gt;boost&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;demandReduction&lt;/span&gt; &lt;span class="err"&gt;×&lt;/span&gt; &lt;span class="mf"&gt;0.25&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The guard at 85°F is important. Hot weather drives real water demand regardless of clouds or humidity. Above that threshold, evaporative demand is high enough that the boost doesn't apply.&lt;/p&gt;

&lt;p&gt;This is a small adjustment, 0.25 at maximum, but it prevents the engine from recommending watering on days when the lawn genuinely doesn't need it. Overwatering is a real problem, especially for casual gardeners who might not realize that a cool, overcast day means their yard is fine.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Meta-Lesson
&lt;/h2&gt;

&lt;p&gt;Every one of these edge cases started as a wrong verdict. A friend texted me "your app said Yes but the trail was iced over." A beta tester reported "it's telling me to water but it's 40 degrees." More personally, I'm literally looking at my skateboard ramp covered in ice and the app telling me it's shred-ready. Nope.&lt;/p&gt;

&lt;p&gt;The temptation each time was to add a quick patch, an &lt;code&gt;if&lt;/code&gt; statement for the specific scenario. What I tried to do instead was understand &lt;em&gt;why&lt;/em&gt; the model was wrong and fix the underlying assumption. Usually the answer was: the model was treating something as a smooth continuum when reality has phase transitions and state changes.&lt;/p&gt;

&lt;p&gt;Water doesn't gradually become less liquid as it gets colder. It freezes. Plants don't linearly reduce water uptake as temperature drops. They go dormant. Snow doesn't dry like rain. It melts.&lt;/p&gt;

&lt;p&gt;The edge cases are where the domain expertise lives. The drying model is arithmetic. The freeze/thaw logic is hard-won knowledge about how the physical world actually works.&lt;/p&gt;

&lt;h2&gt;
  
  
  Next in the Series
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/the-lab/2026-03-25-flipping-the-question/"&gt;next article&lt;/a&gt; covers the Yardwise inversion, how the engine flips from "is it too wet?" to "is it too dry?" and the additional features (manual watering tracking, establishment sensitivity) that make gardening a distinct problem from riding and field sports.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;The Groundwise engine powers &lt;a href="https://stalefishlabs.com/apps/ridewise/" rel="noopener noreferrer"&gt;Ridewise&lt;/a&gt;, &lt;a href="https://stalefishlabs.com/apps/fieldwise/" rel="noopener noreferrer"&gt;Fieldwise&lt;/a&gt;, and &lt;a href="https://stalefishlabs.com/apps/yardwise/" rel="noopener noreferrer"&gt;Yardwise&lt;/a&gt; — all available for iOS from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
    </item>
    <item>
      <title>One Engine, Three Apps: Sharing a Swift Decision Engine Across Products</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Fri, 20 Mar 2026 14:00:28 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/one-engine-three-apps-sharing-a-swift-decision-engine-across-products-4lb0</link>
      <guid>https://dev.to/stalefishlabs/one-engine-three-apps-sharing-a-swift-decision-engine-across-products-4lb0</guid>
      <description>&lt;p&gt;In the &lt;a href="https://dev.to/the-lab/2026-03-05-weather-engine-intro/"&gt;previous articles&lt;/a&gt; I've covered what the Groundwise engine does and &lt;a href="https://dev.to/the-lab/2026-03-12-drying-model/"&gt;how the drying model works&lt;/a&gt;. This article is about the architectural decision that turned one app into three: sharing a single decision engine across Ridewise (trail conditions), Fieldwise (sports field conditions), and Yardwise (watering guidance).&lt;/p&gt;

&lt;p&gt;The pitch sounds clean: "one engine, three apps." The reality required some specific design choices to keep it from becoming a tangled mess of conditionals.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Shape of the Problem
&lt;/h2&gt;

&lt;p&gt;All three apps answer the same fundamental question: &lt;strong&gt;what's the moisture situation at this spot?&lt;/strong&gt; But each app:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Cares about different &lt;strong&gt;surfaces&lt;/strong&gt; (skateparks vs. soccer fields vs. herb gardens)&lt;/li&gt;
&lt;li&gt;Has different &lt;strong&gt;thresholds&lt;/strong&gt; for what counts as "too wet" or "too dry"&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interprets the verdict differently&lt;/strong&gt; (wet is bad for riders, good for gardeners)&lt;/li&gt;
&lt;li&gt;Needs &lt;strong&gt;app-specific logic&lt;/strong&gt; (gardeners track manual watering, riders don't)&lt;/li&gt;
&lt;li&gt;Uses &lt;strong&gt;different language&lt;/strong&gt; in the rationale ("trail might be muddy" vs. "field may hold water" vs. "soil has enough moisture")&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The question was whether to fork the engine into three copies, or keep one engine and parameterize the differences. I went with parameterization — and the key that made it work was keeping the customization surface small.&lt;/p&gt;

&lt;h2&gt;
  
  
  EngineMode: Flipping the Perspective
&lt;/h2&gt;

&lt;p&gt;The most important type in the engine might be the simplest:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;enum&lt;/span&gt; &lt;span class="kt"&gt;EngineMode&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="n"&gt;wetnessConcern&lt;/span&gt;    &lt;span class="c1"&gt;// Ridewise, Fieldwise&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="n"&gt;drynessConcern&lt;/span&gt;    &lt;span class="c1"&gt;// Yardwise&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The engine always calculates a wetness score from 0 (bone dry) to 1 (saturated). &lt;code&gt;EngineMode&lt;/code&gt; controls what that score &lt;em&gt;means&lt;/em&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Wetness concern:&lt;/strong&gt; Low score = Yes (go ride), high score = No (too wet)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dryness concern:&lt;/strong&gt; Low score = Yes (water your plants), high score = No (skip watering)&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The verdict enum is the same in both modes — &lt;code&gt;Yes&lt;/code&gt;, &lt;code&gt;Maybe&lt;/code&gt;, &lt;code&gt;No&lt;/code&gt; — but the &lt;em&gt;interpretation&lt;/em&gt; inverts. This is a deliberate choice. The consuming app doesn't need to know which mode produced the verdict. It just renders green for Yes, orange for Maybe, red for No.&lt;/p&gt;

&lt;h2&gt;
  
  
  SiteType: A Unified Wrapper
&lt;/h2&gt;

&lt;p&gt;Each app has its own domain vocabulary. Ridewise has "spots" (trails, skateparks), Fieldwise has "fields" (baseball diamonds, tennis courts), Yardwise has "areas" (lawns, raised beds). Rather than making the engine accept three different input types, they're wrapped in a single enum:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;enum&lt;/span&gt; &lt;span class="kt"&gt;SiteType&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="nf"&gt;spot&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;SpotType&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;     &lt;span class="c1"&gt;// Ridewise: trail, skatepark, bikeJumps, pumpTrack...&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="nf"&gt;field&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;FieldType&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;   &lt;span class="c1"&gt;// Fieldwise: baseball, soccer, tennis, rugby...&lt;/span&gt;
    &lt;span class="k"&gt;case&lt;/span&gt; &lt;span class="nf"&gt;area&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;AreaType&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;     &lt;span class="c1"&gt;// Yardwise: lawn, raisedBed, container, compost...&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Each case maps to a &lt;code&gt;SurfaceType&lt;/code&gt; — the thing the engine actually cares about. A &lt;code&gt;SpotType.skatepark&lt;/code&gt; maps to &lt;code&gt;SurfaceType.concrete&lt;/code&gt;. A &lt;code&gt;FieldType.baseball&lt;/code&gt; maps to &lt;code&gt;SurfaceType.naturalGrass&lt;/code&gt;. A &lt;code&gt;AreaType.container&lt;/code&gt; maps to &lt;code&gt;SurfaceType.pottingMix&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;The engine never branches on &lt;code&gt;SpotType&lt;/code&gt; or &lt;code&gt;FieldType&lt;/code&gt; directly. It resolves the surface type up front, then works exclusively with surface properties. This is what keeps the core logic free of app-specific conditionals.&lt;/p&gt;

&lt;h2&gt;
  
  
  Surface Types: The Parameterization Layer
&lt;/h2&gt;

&lt;p&gt;Seventeen surface types encode the physical properties that actually matter for moisture modeling:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Each surface type defines:&lt;/span&gt;
&lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;dryingMultiplier&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;      &lt;span class="c1"&gt;// 0.7 (clay) to 2.8 (metal)&lt;/span&gt;
&lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;damageSensitivity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;     &lt;span class="c1"&gt;// 0.0 to 1.0&lt;/span&gt;
&lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;isDrainingSurface&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Bool&lt;/span&gt;       &lt;span class="c1"&gt;// sheds water vs. absorbs&lt;/span&gt;
&lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;isAbsorbentSurface&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Bool&lt;/span&gt;      &lt;span class="c1"&gt;// holds water in material&lt;/span&gt;
&lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;safetySensitivity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;     &lt;span class="c1"&gt;// slip risk when wet&lt;/span&gt;
&lt;span class="k"&gt;var&lt;/span&gt; &lt;span class="nv"&gt;qualitySensitivity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;    &lt;span class="c1"&gt;// quality degradation when wet&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The engine uses these properties — never the surface type identity — to modulate its calculations. Drying multiplier scales how fast moisture clears. Damage sensitivity controls the sensitivity veto (should the engine push borderline verdicts toward protection?). Draining vs. absorbent determines whether residual wetness applies.&lt;/p&gt;

&lt;p&gt;This means adding a new surface type is a data change, not a logic change. If someone wanted to add "packed gravel" for Ridewise, they'd define its properties and it would flow through the existing pipeline.&lt;/p&gt;

&lt;h2&gt;
  
  
  Threshold Calibration Per Mode
&lt;/h2&gt;

&lt;p&gt;The verdict thresholds differ between wetness concern and dryness concern:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Yes&lt;/th&gt;
&lt;th&gt;Maybe&lt;/th&gt;
&lt;th&gt;No&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Wetness concern&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&amp;lt; 0.30&lt;/td&gt;
&lt;td&gt;0.30 – 0.60&lt;/td&gt;
&lt;td&gt;≥ 0.60&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Dryness concern&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&amp;lt; 0.15&lt;/td&gt;
&lt;td&gt;0.15 – 0.45&lt;/td&gt;
&lt;td&gt;≥ 0.45&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Yardwise thresholds are shifted lower because the consequences are asymmetric. For a rider, going out on a borderline trail risks damaging the trail surface. For a gardener, missing one watering day rarely kills plants. The engine leans toward "maybe water" rather than "definitely water" because overwatering is its own problem.&lt;/p&gt;

&lt;p&gt;The sensitivity veto also inverts:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Wetness concern:&lt;/strong&gt; If a sensitive surface (like natural grass with 0.9 damage sensitivity) gets a Maybe verdict with wetness above 0.4, it's pushed to No. Protect the surface.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dryness concern:&lt;/strong&gt; If a sensitive surface (like fresh seed with 0.95 effective sensitivity) gets a Maybe verdict with wetness below 0.3, it's pushed to Yes. Water the fragile plants.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Same mechanism, opposite direction. One line of mode-aware logic handles both cases.&lt;/p&gt;

&lt;h2&gt;
  
  
  App-Specific Features Without Conditionals
&lt;/h2&gt;

&lt;p&gt;Yardwise has two features the other apps don't: manual watering tracking and cold-weather dormancy suppression. Rather than branching on app identity, these are driven by the input data:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Manual watering&lt;/strong&gt; is an array of &lt;code&gt;WateringEvent&lt;/code&gt; values on the input struct. Ridewise and Fieldwise pass an empty array. The engine's watering contribution calculation gracefully returns zero when there are no events — no conditional needed.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Establishment sensitivity&lt;/strong&gt; is a &lt;code&gt;Double&lt;/code&gt; on the input (0.0 by default). Yardwise sets it to 0.5 for newly seeded areas and 0.2 for newly planted ones, boosting the surface's damage sensitivity. Ridewise and Fieldwise leave it at 0.0. Again, no branching — the math just works with a zero boost.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Cold-weather dormancy&lt;/strong&gt; activates when the temperature drops below 55°F. It injects additional "wetness" into the Yardwise calculation, suppressing watering recommendations when plants are dormant. This &lt;em&gt;is&lt;/em&gt; gated on &lt;code&gt;EngineMode.drynessConcern&lt;/code&gt; because the concept doesn't make sense for riders — cold weather doesn't make trails &lt;em&gt;less wet&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;This is the one place where I accepted a mode check in the engine, and it was a pragmatic call. Dormancy is fundamentally a gardening concept. Trying to abstract it into a mode-agnostic mechanism would have added complexity without clarity.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Input Struct
&lt;/h2&gt;

&lt;p&gt;Everything flows through a single input type:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;struct&lt;/span&gt; &lt;span class="kt"&gt;GroundwiseInputs&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="c1"&gt;// Weather (required)&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rain24hInches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rain48hInches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rain72hInches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;minutesSinceRainEnded&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Int&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rainPattern&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RainPattern&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;temperatureF&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;sustainedWindMph&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;cloudCoverFraction&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;

    &lt;span class="c1"&gt;// Weather (optional, improves accuracy)&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;gustsMph&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;dewPointF&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;relativeHumidity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;overnightLowF&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;daysSinceLastRain&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Int&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;

    &lt;span class="c1"&gt;// Freeze/thaw context&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;frozenSnowAccumulationInches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;hoursSinceThawBegan&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Int&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;hoursBelowFreezing&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Int&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;

    &lt;span class="c1"&gt;// Site context&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;siteType&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;SiteType&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;surfaceType&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;SurfaceType&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;exposureLevel&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;ExposureLevel&lt;/span&gt;

    &lt;span class="c1"&gt;// Mode and calibration&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;engineMode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;EngineMode&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;establishmentSensitivityBoost&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Double&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;isCurrentlyPrecipitating&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Bool&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;hasThunderstorm&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Bool&lt;/span&gt;

    &lt;span class="c1"&gt;// Yardwise-specific&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;manualWateringEvents&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="kt"&gt;WateringEvent&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Each app constructs this from its own domain model. Ridewise fills in the weather data and its spot's surface type. Yardwise adds watering events and an establishment boost. The engine doesn't know or care which app called it.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Output: Same Structure, Different Meaning
&lt;/h2&gt;

&lt;p&gt;The assessment comes back as:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight swift"&gt;&lt;code&gt;&lt;span class="kd"&gt;struct&lt;/span&gt; &lt;span class="kt"&gt;GroundwiseAssessment&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;verdict&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Verdict&lt;/span&gt;           &lt;span class="c1"&gt;// .yes / .maybe / .no&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;confidence&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;Confidence&lt;/span&gt;     &lt;span class="c1"&gt;// .low / .medium / .high&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;rationale&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;GroundwiseRationale&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;riskSurfaceDamage&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RiskLevel&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;riskActivitySafety&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RiskLevel&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;riskActivityQuality&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RiskLevel&lt;/span&gt;
    &lt;span class="k"&gt;let&lt;/span&gt; &lt;span class="nv"&gt;recoveryOutlook&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;RecoveryOutlook&lt;/span&gt;&lt;span class="p"&gt;?&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The consuming app interprets the verdict through its own lens. Ridewise renders Yes as "Dry — go ride." Yardwise renders Yes as "Water today." The engine provides the structured rationale (headline, decisive factor, contributing details), and each app's UI formats it with domain-appropriate language.&lt;/p&gt;

&lt;p&gt;Risk levels work the same way. Surface damage risk on a trail means erosion and ruts. Surface damage risk on a newly seeded lawn means killing the seed. Same risk level, different consequence — the app handles the framing.&lt;/p&gt;

&lt;h2&gt;
  
  
  What I'd Do Differently
&lt;/h2&gt;

&lt;p&gt;The engine's one-file structure (2,193 lines in &lt;code&gt;GroundwiseEngine.swift&lt;/code&gt;) works but isn't ideal. The frozen conditions check alone is 360 lines. If I were starting over, I'd break the pipeline into discrete stages — &lt;code&gt;FreezeAssessor&lt;/code&gt;, &lt;code&gt;PrecipitationAssessor&lt;/code&gt;, &lt;code&gt;DryingCalculator&lt;/code&gt;, &lt;code&gt;VerdictResolver&lt;/code&gt; — each as a separate type with a clear protocol.&lt;/p&gt;

&lt;p&gt;I'd also make the threshold constants configurable per surface type rather than per engine mode. Right now, all wetness-concern surfaces share the same 0.3/0.6 thresholds. But a clay tennis court arguably deserves tighter thresholds than an artificial turf field. The sensitivity veto partially handles this, but explicit per-surface thresholds would be cleaner.&lt;/p&gt;

&lt;p&gt;That said, the current design has shipped and works. Premature refactoring is its own trap.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Tradeoff
&lt;/h2&gt;

&lt;p&gt;Sharing an engine across three apps means accepting constraints:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;You can't special-case easily.&lt;/strong&gt; If Ridewise needs a trail-specific behavior that doesn't generalize, you either make it general enough for the shared engine or handle it in the app layer.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Testing surface area grows.&lt;/strong&gt; Every change to the engine needs to be validated against all three app contexts. A threshold tweak that improves Ridewise verdicts might break Yardwise scenarios.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Abstraction has a ceiling.&lt;/strong&gt; Cold-weather dormancy proved that not everything generalizes cleanly. Knowing when to accept a mode check instead of over-abstracting is a judgment call.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The upside: every improvement to the drying model benefits all three apps simultaneously. When I improved the residual wetness calculation for trails, clay tennis courts and garden beds got more accurate too — because they share the same underlying property (absorbent surfaces retain moisture).&lt;/p&gt;

&lt;p&gt;For a solo developer maintaining three related apps, that leverage is worth the constraints.&lt;/p&gt;

&lt;h2&gt;
  
  
  Next in the Series
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/the-lab/2026-03-26-edge-cases/"&gt;next article&lt;/a&gt; digs into the edge cases that make weather modeling humbling — freeze/thaw cycles, precipitation intensity, snow melt, and cold-weather plant dormancy. Each one is a lesson in how simple models break when they meet the real world.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Ridewise, Fieldwise, and Yardwise are all coming soon for iOS from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;. Built by one developer, powered by one engine.&lt;/em&gt;&lt;/p&gt;

</description>
    </item>
    <item>
      <title>Turning Raw Weather Into a Drying Model</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Tue, 17 Mar 2026 20:31:05 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/turning-raw-weather-into-a-drying-model-3ko1</link>
      <guid>https://dev.to/stalefishlabs/turning-raw-weather-into-a-drying-model-3ko1</guid>
      <description>&lt;p&gt;In the &lt;a href="https://dev.to/the-lab/2026-03-05-weather-engine-intro/"&gt;first article&lt;/a&gt; about my foray into using weather data to assess surface conditions for riding activities, I introduced the Groundwise engine, a software decision system that turns weather data into a yes/maybe/no verdict for outdoor conditions. This article goes deeper into the core moisture model: how the engine takes raw weather observations and calculates a wetness score that drives the verdict. The hope is to show how a simple question such as "can I ride my mountain bike today?" spiraled into a fairly complex yet intriguing design challenge. Totally fair if you aren't entranced by weather math, I get it, but I feel like there's some value in pulling back the curtain to reveal how much goes into solving a seemingly simple problem.&lt;/p&gt;

&lt;p&gt;The Groundwise model is relatively restrainted in scope, it isn't trying to simulate soil physics. It's trying to approximate what an experienced local would know instinctively — "it rained pretty hard yesterday, but it's been warm and windy all morning, so the trails are probably fine." The goal is to encode that intuition into something repeatable and surface-aware.&lt;/p&gt;

&lt;h2&gt;
  
  
  Weighted Precipitation: Not All Rain Is Equal
&lt;/h2&gt;

&lt;p&gt;The engine tracks precipitation across three time windows: the last 24 hours, 24-48 hours ago, and 48-72 hours ago. But it doesn't treat them equally. Here's how they are weighted differently by the weather precipitation equation:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;weatherPrecip = rain24h × 0.7 + (rain48h - rain24h) × 0.2 + (rain72h - rain48h) × 0.1
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Recent rain dominates. An inch in the last 24 hours contributes seven times more to the score than an inch from two days ago. This matches real-world observation, where rain from three days ago has had significant time to drain and evaporate, while yesterday's rain is still actively affecting conditions.&lt;/p&gt;

&lt;p&gt;The subtraction matters too. &lt;code&gt;rain48h&lt;/code&gt; is a &lt;em&gt;cumulative&lt;/em&gt; total (it includes the last 24 hours), so the formula isolates each window's unique contribution. A half an inch total over 48 hours where all of it fell in the last 24 tells a very different story than half an inch spread evenly.&lt;/p&gt;

&lt;h3&gt;
  
  
  Rain Score Normalization
&lt;/h3&gt;

&lt;p&gt;A recent rain results in a raw precipitation value that gets normalized to a 0-1 scale, so effectively a percentage:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;rainScore = min(1.0, totalPrecip / 0.75)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Three-quarters of an inch saturates the score (maximum value of 1, or 100%). Beyond that, more rain doesn't make things &lt;em&gt;more&lt;/em&gt; wet from the engine's perspective — you're already at maximum precipitation/saturation, which matches reality in that a trail, yard, or any other outdoor surface has a limit to how wet it can get. This prevents a 3-inch deluge from producing a wildly different result than a 1-inch soaking. Both are "very wet" — the distinction that matters is how long ago it happened and how fast things are drying.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why Intensity Matters
&lt;/h3&gt;

&lt;p&gt;The engine tracks rain pattern: light, steady, or downpour. It then applies a multiplier to the base wetness given one of those patterns:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Pattern&lt;/th&gt;
&lt;th&gt;Multiplier&lt;/th&gt;
&lt;th&gt;Why&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Light&lt;/td&gt;
&lt;td&gt;0.7x&lt;/td&gt;
&lt;td&gt;Gentle rain soaks in gradually, less runoff, less surface pooling&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Steady&lt;/td&gt;
&lt;td&gt;1.1x&lt;/td&gt;
&lt;td&gt;Sustained saturation, ground can't keep up&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Downpour&lt;/td&gt;
&lt;td&gt;1.5x&lt;/td&gt;
&lt;td&gt;Overwhelms drainage, causes pooling and surface flooding&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;A quarter inch of light rain over several hours is genuinely different from a quarter inch dumped in 20 minutes. The light rain absorbs more evenly. The downpour creates surface water, overwhelms drainage on absorbent surfaces, and can cause erosion on trails.&lt;/p&gt;

&lt;h2&gt;
  
  
  Drying Strength: The Recovery Side
&lt;/h2&gt;

&lt;p&gt;Wetness is only half the picture. The other half is how aggressively conditions are drying things out. The engine calculates a composite drying strength from four weather factors:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;drying = (tempFactor × 0.30) + (windFactor × 0.30) + (humidityFactor × 0.25) + (skyFactor × 0.15)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Temperature (30% weight):&lt;/strong&gt; Warmer air holds more moisture and drives evaporation. The factor scales linearly from 0 at 50°F to 1.0 at 90°F. Below 50°F, evaporation slows dramatically. Above 90°F, you're drying as fast as conditions allow.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;tempFactor = clamp((tempF - 50) / 40, 0, 1)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Wind (30% weight):&lt;/strong&gt; Moving air carries moisture away from surfaces. Scales linearly up to 20 mph, where the effect plateaus - going from 20 to 40 mph doesn't double the drying rate.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;windFactor = clamp(sustainedWindMph / 20, 0, 1)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Humidity (25% weight):&lt;/strong&gt; Dry air absorbs moisture more readily. This is the inverse, where low humidity means strong drying.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;humidityFactor = clamp(1.0 - effectiveHumidity, 0, 1)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;When the weather API provides a dew point instead of relative humidity, the engine converts it using the Magnus formula. Dew point is actually the more reliable measurement — relative humidity fluctuates throughout the day even when actual moisture content stays constant.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Sky cover (15% weight):&lt;/strong&gt; Clear skies mean solar radiation hitting surfaces directly, which drives evaporation. Clouds block that. This gets the lowest weight because its effect is real but smaller than the others.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;skyFactor = clamp(1.0 - cloudCover, 0, 1)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Exposure Matters
&lt;/h3&gt;

&lt;p&gt;All of this gets modified by where the surface actually sits. A trail under heavy tree canopy dries differently than an open field fully exposed to sunlight:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Exposure&lt;/th&gt;
&lt;th&gt;Rain Multiplier&lt;/th&gt;
&lt;th&gt;Drying Multiplier&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Exposed&lt;/td&gt;
&lt;td&gt;1.0x&lt;/td&gt;
&lt;td&gt;1.0x&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Shaded&lt;/td&gt;
&lt;td&gt;0.7x&lt;/td&gt;
&lt;td&gt;0.6x&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Covered&lt;/td&gt;
&lt;td&gt;0.0x&lt;/td&gt;
&lt;td&gt;0.8x&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Shaded spots get less rain (canopy intercepts 30%) but also dry 40% slower (less sun, less wind). Covered spots (under a roof or overhang) get no rain at all but still have air circulation for moderate drying.&lt;/p&gt;

&lt;p&gt;This creates an interesting dynamic: a shaded trail might actually be &lt;em&gt;drier&lt;/em&gt; than an exposed one after light rain (less water reached it) but &lt;em&gt;wetter&lt;/em&gt; after heavy rain (the rain that got through takes longer to leave).&lt;/p&gt;

&lt;h3&gt;
  
  
  Drying Classification
&lt;/h3&gt;

&lt;p&gt;The composite score maps to three tiers, each returning a fixed drying effectiveness value:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Score Range&lt;/th&gt;
&lt;th&gt;Classification&lt;/th&gt;
&lt;th&gt;Effectiveness&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;≥ 0.7&lt;/td&gt;
&lt;td&gt;Strong&lt;/td&gt;
&lt;td&gt;0.8&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;0.4 – 0.7&lt;/td&gt;
&lt;td&gt;Moderate&lt;/td&gt;
&lt;td&gt;0.5&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&amp;lt; 0.4&lt;/td&gt;
&lt;td&gt;Weak&lt;/td&gt;
&lt;td&gt;0.2&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;I deliberately chose discrete tiers over a continuous curve. The difference between a 0.41 and a 0.69 drying score isn't meaningful in practice — both represent "conditions are helping somewhat." The tiers prevent false precision while still capturing the real distinction between "sunny and breezy" (strong), "overcast and mild" (moderate), and "cold, humid, and still" (weak).&lt;/p&gt;

&lt;h2&gt;
  
  
  Combining It All: The Wetness Score
&lt;/h2&gt;

&lt;p&gt;I warned you this problem has more nuance that it would seem. But hang in there, we're getting closer to arriving at some meaningful mathematical conclusions. For example, the wetness score blends precipitation and drying into a single 0-1 value:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;baseWetness = rainScore × 0.5 + (rainScore × timingScore) × 0.6
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This formula does something subtle. The first term (&lt;code&gt;rainScore × 0.5&lt;/code&gt;) ensures that heavy rain always contributes &lt;em&gt;some&lt;/em&gt; wetness regardless of timing. The second term (&lt;code&gt;rainScore × timingScore&lt;/code&gt;) captures the interaction — recent heavy rain is much worse than old heavy rain. The timing score decays linearly from 1.0 (just stopped) to 0.0 (24+ hours ago).&lt;/p&gt;

&lt;p&gt;After the base calculation, the rain pattern multiplier is applied (0.7x for light, 1.1x for steady, 1.5x for downpour), then drying reduces it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;dryingEffect = dryingScore × 0.3 × dryingEffectiveness
wetness = baseWetness × (1.0 - dryingEffect)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;dryingEffectiveness&lt;/code&gt; factor prevents drying from being too aggressive when rain just ended. If rain stopped 30 minutes ago, even strong drying conditions haven't had time to do much yet. The factor scales up as time passes, so drying's impact grows the longer it's been since rain.&lt;/p&gt;

&lt;h3&gt;
  
  
  A Worked Example
&lt;/h3&gt;

&lt;p&gt;To put all these equations into perspective, let's trace through a real scenario to arrive at a Groundwise verdict: &lt;strong&gt;0.4 inches of steady rain ended 8 hours ago. It's 72°F, 12 mph wind, 45% humidity, 20% cloud cover. Exposed dirt trail.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Rain score:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;weatherPrecip = 0.4 × 0.7 = 0.28  (all in last 24h)
rainScore = min(1.0, 0.28 / 0.75) = 0.37
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Timing score:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;hours = 480 min / 60 = 8
timingScore = max(0, 1.0 - 8/24) = 0.67
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Drying strength:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;temp = (72-50)/40 × 0.30 = 0.165
wind = 12/20 × 0.30 = 0.18
humidity = 0.55 × 0.25 = 0.1375
sky = 0.80 × 0.15 = 0.12
total = 0.60 → Moderate (effectiveness = 0.5)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Wetness:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;base = 0.37 × 0.5 + (0.37 × 0.67) × 0.6 = 0.185 + 0.149 = 0.334
× steady pattern (1.1) = 0.367
dryingEffectiveness = max(0.2, 1.0 - 0.67 × 0.5) = 0.665
dryingEffect = 0.5 × 0.3 × 0.665 = 0.10
wetness = 0.367 × (1.0 - 0.10) = 0.33
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Verdict: Maybe&lt;/strong&gt; (0.33 is just above the 0.3 threshold). The trail is borderline — rideable but still damp. On a dirt trail (damage sensitivity 0.5), the sensitivity veto wouldn't trigger. A reasonable call either way, and the engine goes with Maybe, giving the rider the opportunity to then weigh locale-specific details such as trail sensitivity to damage.&lt;/p&gt;

&lt;p&gt;Now change one variable — make it 85°F instead of 72°F:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;temp = (85-50)/40 × 0.30 = 0.2625
total drying = 0.70 → Strong (effectiveness = 0.8)
dryingEffect = 0.8 × 0.3 × 0.665 = 0.16
wetness = 0.367 × (1.0 - 0.16) = 0.308
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Still Maybe, but barely. A bit more wind or another hour of drying and it flips to Yes. That matches intuition — a hot afternoon pulls moisture out fast.&lt;/p&gt;

&lt;h2&gt;
  
  
  Residual Wetness: The Ground Remembers
&lt;/h2&gt;

&lt;p&gt;The timing-based model handles most scenarios well, but it has a blind spot: &lt;strong&gt;ground saturation after heavy rain on absorbent surfaces.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;If it rained an inch on Monday and you're checking the trail on Wednesday, the timing score says "it's been 48 hours, moisture contribution is minimal." But anyone who's walked a clay trail two days after heavy rain knows that's wrong. The ground is still holding water.&lt;/p&gt;

&lt;p&gt;The engine adds a residual wetness component for absorbent surfaces (dirt, grass, clay, amended soil) when precipitation exceeded 0.25 inches:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;volumeFactor = clamp((rain - 0.25) / 0.75, 0, 1)
decayFactor = based on hours since rain and drying strength
surfaceRetention = inverse of surface drying multiplier
dryingReduction = strength-based reduction

residualWetness = 0.55 × volumeFactor × decayFactor × surfaceRetention × (1.0 - dryingReduction)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The peak residual value of ~0.55 deliberately sits in the middle of the Maybe range. It's not enough to trigger a hard No, but it keeps the engine from prematurely saying Yes on saturated ground.&lt;/p&gt;

&lt;p&gt;Clay surfaces (drying multiplier 0.7x) retain the most residual moisture. Concrete and metal (2.0x+) don't get residual wetness at all, they're draining surfaces that hold little (concrete) to no (metal) water.&lt;/p&gt;

&lt;h2&gt;
  
  
  What This Model Doesn't Do
&lt;/h2&gt;

&lt;p&gt;A few things I intentionally left out:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Soil type modeling.&lt;/strong&gt; Real evapotranspiration models account for soil composition, drainage rates, water table depth. The engine uses surface type as a proxy instead. A dirt trail in sandy Arizona soil dries differently than one in Georgia red clay, and the engine can't distinguish them. The tradeoff is simplicity — asking users to classify their soil composition seemed like a bridge too far. If you disagree, let us know, but I decided to err on the side of simplicity at least in terms of user inputs.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Microclimate effects.&lt;/strong&gt; Two spots a mile apart can have meaningfully different conditions. The engine uses a single weather observation for each saved location, which might come from a station several miles away. Elevation, valley effects, and urban heat islands aren't modeled.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Drainage infrastructure.&lt;/strong&gt; A well-designed trail with proper drainage handles rain better than a flat trail in a depression. An athletic field with subsurface drainage is ready for play sooner than one without. The engine doesn't know about this. Surface type captures some of it (artificial turf implies drainage engineering), but it's imperfect.&lt;/p&gt;

&lt;p&gt;These are all real limitations, and I'd rather be transparent about them than pretend the model is more precise than it is. The engine targets "better than guessing" — not "better than walking over and checking yourself."&lt;/p&gt;

&lt;h2&gt;
  
  
  Next in the Series
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/the-lab/2026-03-19-one-engine-three-apps/"&gt;next article&lt;/a&gt; covers how this engine is packaged as a shared Swift framework consumed by three different apps — each with its own surface library, threshold calibration, and verdict interpretation. Same core math, three different products. It's a lesson in code reuse, and the benefits of solving a problem once in just a general enough way to apply that solution multiple times.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;The drying model powers &lt;a href="https://stalefishlabs.com/apps/ridewise/" rel="noopener noreferrer"&gt;Ridewise&lt;/a&gt;, &lt;a href="https://stalefishlabs.com/apps/fieldwise/" rel="noopener noreferrer"&gt;Fieldwise&lt;/a&gt;, and &lt;a href="https://stalefishlabs.com/apps/yardwise/" rel="noopener noreferrer"&gt;Yardwise&lt;/a&gt; — all coming soon for iOS from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>algorithms</category>
      <category>datascience</category>
      <category>showdev</category>
      <category>sideprojects</category>
    </item>
    <item>
      <title>The Pole Sitter Strategy: How We Fixed a Scoring Loophole</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Fri, 13 Mar 2026 17:02:26 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/the-pole-sitter-strategy-how-we-fixed-a-scoring-loophole-45ll</link>
      <guid>https://dev.to/stalefishlabs/the-pole-sitter-strategy-how-we-fixed-a-scoring-loophole-45ll</guid>
      <description>&lt;p&gt;Before &lt;a href="https://stalefishlabs.com/apps/openwheelers/" rel="noopener noreferrer"&gt;Open Wheelers&lt;/a&gt; was an app, it was a text thread. A group of friends, a shared note, picks submitted before qualifying. One of those friends figured out something the rest of us missed: you could win the whole league by making the same Podium pick every single week.&lt;/p&gt;

&lt;p&gt;Her strategy was laughably simple. Wait for qualifying, pick whoever was on pole position, and move on to baking amazing cakes for F1 brunch. Seriously. No research, no gut feelings, no agonizing over race pace versus one-lap speed. Just: who's P1 on the grid, and is this week feeling more strawberry or lemon? I won't divulge any names, but hers rhymes with Sammy, although this year we just call her champ.&lt;/p&gt;

&lt;p&gt;Because she won the league. And the rest of us were annoyed enough to wonder why.&lt;/p&gt;

&lt;h2&gt;
  
  
  The old scoring made it easy
&lt;/h2&gt;

&lt;p&gt;Our original manual league used this scoring system:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Category&lt;/th&gt;
&lt;th&gt;Points&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Podium&lt;/td&gt;
&lt;td&gt;5 for P1, 3 for P2, 1 for P3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;DNF&lt;/td&gt;
&lt;td&gt;3 for first retirement only&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Fastest Lap&lt;/td&gt;
&lt;td&gt;1 point&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;See the problem? The Podium category was worth up to &lt;strong&gt;5 points&lt;/strong&gt; while DNF maxed out at 3 and Fastest Lap was a throwaway single point. The game was structurally a Podium-picking contest with two minor side bets. If you could crack the Podium category, the other picks barely mattered.&lt;/p&gt;

&lt;p&gt;And cracking the Podium category turns out to be remarkably easy when you just pick the pole sitter.&lt;/p&gt;

&lt;h2&gt;
  
  
  How often does pole become podium?
&lt;/h2&gt;

&lt;p&gt;We looked at every F1 race from 2016 through 2024 — the same decade of data we used in our &lt;a href="https://dev.to/the-lab/2026-03-04-the-none-trap-dnf-game-theory/"&gt;DNF analysis&lt;/a&gt;. Here's how the pole sitter fared:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Season&lt;/th&gt;
&lt;th&gt;Races&lt;/th&gt;
&lt;th&gt;Pole wins&lt;/th&gt;
&lt;th&gt;Pole P2&lt;/th&gt;
&lt;th&gt;Pole P3&lt;/th&gt;
&lt;th&gt;Pole on podium&lt;/th&gt;
&lt;th&gt;Off podium&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;2016&lt;/td&gt;
&lt;td&gt;21&lt;/td&gt;
&lt;td&gt;13&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;17 (81%)&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2017&lt;/td&gt;
&lt;td&gt;20&lt;/td&gt;
&lt;td&gt;11&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;16 (80%)&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2018&lt;/td&gt;
&lt;td&gt;21&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;15 (71%)&lt;/td&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2019&lt;/td&gt;
&lt;td&gt;21&lt;/td&gt;
&lt;td&gt;8&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;14 (67%)&lt;/td&gt;
&lt;td&gt;7&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2020&lt;/td&gt;
&lt;td&gt;17&lt;/td&gt;
&lt;td&gt;10&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;14 (82%)&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2021&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;td&gt;11&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;16 (73%)&lt;/td&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2022&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;td&gt;9&lt;/td&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;15 (68%)&lt;/td&gt;
&lt;td&gt;7&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2023&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;td&gt;14&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;19 (86%)&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2024&lt;/td&gt;
&lt;td&gt;24&lt;/td&gt;
&lt;td&gt;11&lt;/td&gt;
&lt;td&gt;5&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;18 (75%)&lt;/td&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The pole sitter finishes on the podium roughly &lt;strong&gt;75% of the time&lt;/strong&gt; across the modern era. That's not a strategy — that's a cheat code.&lt;/p&gt;

&lt;h2&gt;
  
  
  The pole sitter under old scoring
&lt;/h2&gt;

&lt;p&gt;Let's see what "always pick the pole sitter" actually produced under the old 5-3-1 system. Take 2023, the best season for this strategy:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;14 wins × 5 points = 70&lt;/li&gt;
&lt;li&gt;3 runner-ups × 3 points = 9&lt;/li&gt;
&lt;li&gt;2 third-place finishes × 1 point = 2&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Season total: 81 points from Podium alone&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Meanwhile, the maximum possible from the other two categories combined was about 66 points for DNF (3 × 22 races, if you nailed every single one) and 22 for Fastest Lap (1 × 22). Realistically, even a sharp player might score 25-30 across those categories, but in reality choosing &lt;em&gt;first&lt;/em&gt; DNF turned out to be incredibly difficult (Fastest Lap wasn't much better).&lt;/p&gt;

&lt;p&gt;So our pole sitter friend was pulling in roughly 60-80 Podium points per season while everyone else scrambled to make up the gap with DNF and Fastest Lap picks that were worth a fraction as much. The scoring wasn't balanced, it was broken. Our friend just noticed the breakage and exploited it while the rest of us picked (and lost!) with our hearts.&lt;/p&gt;

&lt;h2&gt;
  
  
  The fix: flatten the pyramid
&lt;/h2&gt;

&lt;p&gt;When we built Open Wheelers as a proper app, we had a chance to redesign the scoring from scratch. The key change was simple: &lt;strong&gt;3-2-1 across all three categories&lt;/strong&gt;. We even named our underlying fantasy scoring engine Podium to highlight this design decision. &lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Category&lt;/th&gt;
&lt;th&gt;Points&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Podium&lt;/td&gt;
&lt;td&gt;3 for P1, 2 for P2, 1 for P3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Overtaker&lt;/td&gt;
&lt;td&gt;3 for most positions gained, 2 for 2nd, 1 for 3rd&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;DNF&lt;/td&gt;
&lt;td&gt;3 for 1st retirement, 2 for 2nd, 1 for 3rd&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Every category now has the same ceiling. No single pick dominates. Let's rerun the pole sitter strategy under the new system.&lt;/p&gt;

&lt;h2&gt;
  
  
  The pole sitter under new scoring
&lt;/h2&gt;

&lt;p&gt;Same 2023 season, same strategy, new math:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;14 wins × 3 points = 42&lt;/li&gt;
&lt;li&gt;3 runner-ups × 2 points = 6&lt;/li&gt;
&lt;li&gt;2 third-place finishes × 1 point = 2&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Season total: 50 points from Podium&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Still solid — but now the Overtaker and DNF categories carry equal weight. A player who scores well across all three categories can absolutely overtake (pun intended) the pole-sitting, cake-baking rules anarchist.&lt;/p&gt;

&lt;p&gt;Consider a well-rounded player who averages just 1.5 points per race across Overtaker and DNF — modest accuracy, not perfection. Over 22 races, that's 33 points from those two categories alone. Add a reasonable Podium performance of, say, 35 points (less than the pole sitter, but making smarter individual picks), and you're at 68 points total versus the pole sitter's 50-plus-whatever-they-stumble-into on Overtaker and DNF.&lt;/p&gt;

&lt;h2&gt;
  
  
  The deeper fix: replacing Fastest Lap with Overtaker
&lt;/h2&gt;

&lt;p&gt;The old system's other problem was that two of the three categories — Podium and Fastest Lap — correlated heavily with the same thing: having the fastest car. The driver on pole was usually also the one most likely to set the fastest lap. If you picked the dominant driver for both, you were essentially making one pick and getting credit for two.&lt;/p&gt;

&lt;p&gt;Overtaker breaks that correlation completely. The driver who gains the most positions is almost never the pole sitter — by definition, they started at the front with nowhere to climb. The Overtaker category rewards knowledge of the &lt;em&gt;rest&lt;/em&gt; of the grid: who qualified poorly but has strong race pace, who's taking engine penalties, which midfield team nailed their setup for the race even if qualifying didn't go their way. It's sort of the anti-qualifying pick, which makes it a fun bookend to the Podium pick, and also provides motivation to wade deeper into the grid for a pick.&lt;/p&gt;

&lt;p&gt;This also means the pole sitter strategy now only helps you in one of three categories. The other two require completely different analysis. That's a game with real strategic breadth.&lt;/p&gt;

&lt;h2&gt;
  
  
  Does the pole sitter strategy still work?
&lt;/h2&gt;

&lt;p&gt;It's still a &lt;em&gt;good&lt;/em&gt; Podium pick — hitting the podium 75% of the time is nothing to sneeze at. But under balanced 3-2-1 scoring, it's no longer a league-winning exploit. It's a floor, not a ceiling.&lt;/p&gt;

&lt;p&gt;The players who will win Open Wheelers leagues are the ones who can pick Podium finishers with similar accuracy to the pole sitter &lt;em&gt;and&lt;/em&gt; identify the likely Overtaker &lt;em&gt;and&lt;/em&gt; read the DNF tea leaves. That's three distinct skills instead of one repeated shortcut.&lt;/p&gt;

&lt;p&gt;Which is exactly what a fantasy game should reward: breadth of knowledge, not a single lazy insight applied 24 times.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;&lt;a href="https://stalefishlabs.com/apps/openwheelers/" rel="noopener noreferrer"&gt;Open Wheelers&lt;/a&gt; is a casual F1 and IndyCar fantasy game for friends, built by &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>algorithms</category>
      <category>devjournal</category>
      <category>showdev</category>
      <category>sideprojects</category>
    </item>
    <item>
      <title>I Built a Weather Engine That Tells You When to Ride, Play, or Water</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Fri, 13 Mar 2026 16:30:47 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/i-built-a-weather-engine-that-tells-you-when-to-ride-play-or-water-5418</link>
      <guid>https://dev.to/stalefishlabs/i-built-a-weather-engine-that-tells-you-when-to-ride-play-or-water-5418</guid>
      <description>&lt;p&gt;Every mountain biker knows the ritual. It rained last night. You check the radar, clear now. You check the trail association's Facebook page, nobody's posted. You text your riding buddy: "Think the trails are good?" They don't know either. So you either stay home and miss a perfectly rideable day, or show up and chew through muddy trails that needed another six hours to dry.&lt;/p&gt;

&lt;p&gt;I got tired of guessing so I built a weather decision engine that answers the question directly: &lt;strong&gt;is it too wet to ride?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Then I realized the same engine could answer two more questions: &lt;strong&gt;is this field playable?&lt;/strong&gt; and &lt;strong&gt;does my garden need watering?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;This is the story of the Groundwise engine, a single Swift package that powers three iOS apps by asking the same underlying question from different perspectives.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Problem With "Did It Rain?"
&lt;/h2&gt;

&lt;p&gt;Weather apps mostly tell you what &lt;em&gt;will&lt;/em&gt; happen, and to a lesser degree they can tell you &lt;em&gt;what&lt;/em&gt; happened. What they don't tell you is &lt;em&gt;what it means&lt;/em&gt; for the specific thing you want to do.&lt;/p&gt;

&lt;p&gt;Half an inch of rain means completely different things depending on context:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;On a &lt;strong&gt;concrete skatepark&lt;/strong&gt;, it sheds in a couple hours. You're probably fine by afternoon.&lt;/li&gt;
&lt;li&gt;On a &lt;strong&gt;dirt trail&lt;/strong&gt;, it might need 24 hours with good sun and wind. Or 48 hours or more if it's overcast and cold.&lt;/li&gt;
&lt;li&gt;On a &lt;strong&gt;clay tennis court&lt;/strong&gt;, you might be waiting even longer, clay holds moisture and damages easily when wet.&lt;/li&gt;
&lt;li&gt;In a &lt;strong&gt;container garden on a sunny patio&lt;/strong&gt;, that half inch drained through the potting mix hours ago and your herbs might need water again tomorrow.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The answer isn't just "how much rain," it's how much rain, on what surface, how long ago, and what the drying conditions have been since.&lt;/p&gt;

&lt;h2&gt;
  
  
  From Weather Data to a Verdict
&lt;/h2&gt;

&lt;p&gt;So I built a weather analysis engine that takes in a handful of weather observations and produces a single categorical verdict regarding an action on a specific surface: &lt;strong&gt;Yes&lt;/strong&gt;, &lt;strong&gt;Maybe&lt;/strong&gt;, or &lt;strong&gt;No&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;The inputs are straightforward, stuff you'd get from any weather API:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Precipitation totals (last 24, 48, and 72 hours)&lt;/li&gt;
&lt;li&gt;How long since rain ended&lt;/li&gt;
&lt;li&gt;Whether it was light, steady, or a downpour&lt;/li&gt;
&lt;li&gt;Current temperature, wind speed, humidity, and cloud cover&lt;/li&gt;
&lt;li&gt;Whether it's actively raining right now&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Plus one critical piece of context: &lt;strong&gt;what surface are you asking about?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The engine defines 17 surface types across three categories. Each has a drying multiplier that controls how fast moisture clears, for example:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Surface&lt;/th&gt;
&lt;th&gt;Drying Speed&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Metal skateboard ramps&lt;/td&gt;
&lt;td&gt;2.8x&lt;/td&gt;
&lt;td&gt;Fastest, sheds water, heats up quickly&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Artificial turf&lt;/td&gt;
&lt;td&gt;2.5x&lt;/td&gt;
&lt;td&gt;Engineered to drain&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Asphalt&lt;/td&gt;
&lt;td&gt;2.2x&lt;/td&gt;
&lt;td&gt;Dark surface, absorbs heat&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Concrete&lt;/td&gt;
&lt;td&gt;2.0x&lt;/td&gt;
&lt;td&gt;Drains well, slower to heat than asphalt&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Potting mix&lt;/td&gt;
&lt;td&gt;2.0x&lt;/td&gt;
&lt;td&gt;Loose, fast-draining soil&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Compost&lt;/td&gt;
&lt;td&gt;1.2x&lt;/td&gt;
&lt;td&gt;Active decomposition generates some heat&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Dirt/ground&lt;/td&gt;
&lt;td&gt;1.0x&lt;/td&gt;
&lt;td&gt;Baseline, absorbs and holds water&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Natural grass&lt;/td&gt;
&lt;td&gt;1.0x&lt;/td&gt;
&lt;td&gt;Root systems retain moisture&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Amended soil (mulched)&lt;/td&gt;
&lt;td&gt;0.7x&lt;/td&gt;
&lt;td&gt;Mulch deliberately slows evaporation&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Clay&lt;/td&gt;
&lt;td&gt;0.7x&lt;/td&gt;
&lt;td&gt;Dense, holds water, slow to release&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;That 4x difference between metal and clay isn't just a number, it's the difference between "rideable in an hour" and "unplayable until tomorrow."&lt;/p&gt;

&lt;h2&gt;
  
  
  The Decision Pipeline
&lt;/h2&gt;

&lt;p&gt;The engine runs checks in a specific order, with the most critical conditions evaluated first:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1. Is the ground frozen?&lt;/strong&gt; If there's an ice or snow hazard, the verdict is No regardless of moisture. This check alone is about 360 lines of code, freeze/thaw cycles are surprisingly complex. A concrete skatepark clears ice in 6 hours at 55°F, but a dirt trail might need 72 hours at 45°F to fully thaw and dry.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. Is it actively raining?&lt;/strong&gt; Straightforward gate. If precipitation is falling, the answer is No (or Maybe for very light drizzle on a fast-draining surface with strong drying conditions).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Calculate a wetness score.&lt;/strong&gt; This is where the real modeling happens. The engine combines:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A &lt;strong&gt;rain score&lt;/strong&gt; weighted toward recent precipitation (70% from last 24h, 20% from 24-48h, 10% from 48-72h)&lt;/li&gt;
&lt;li&gt;A &lt;strong&gt;timing score&lt;/strong&gt; that decays linearly over 24 hours since rain ended&lt;/li&gt;
&lt;li&gt;A &lt;strong&gt;drying strength&lt;/strong&gt; composite that factors in temperature, wind, humidity, and cloud cover&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Residual wetness&lt;/strong&gt; for absorbent surfaces, heavy rain on dirt or clay retains moisture well beyond what the timing score captures&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;4. Apply the verdict thresholds.&lt;/strong&gt; A wetness score below 0.3 means Yes (dry enough). Between 0.3 and 0.6 means Maybe (borderline). Above 0.6 means No (too wet).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;5. Sensitivity veto.&lt;/strong&gt; High-sensitivity surfaces (like newly seeded lawns or natural grass athletic fields) get pushed from Maybe toward a more protective verdict. The engine would rather tell you to wait than let you damage a surface that's expensive to repair.&lt;/p&gt;

&lt;h2&gt;
  
  
  One Engine, Two Perspectives
&lt;/h2&gt;

&lt;p&gt;If you're wondering how the above, which is described in terms of &lt;strong&gt;using&lt;/strong&gt; a surface, could possibly apply to a container garden, it's a fair question. And this is where the engine morphed into serving a series of apps instead of just one:&lt;/p&gt;

&lt;p&gt;The engine calculates a &lt;strong&gt;wetness score&lt;/strong&gt;. For riders and athletes, high wetness is bad, you want dry conditions. For gardeners, high wetness is good, it means you can skip watering.&lt;/p&gt;

&lt;p&gt;Same math, opposite interpretation:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Wetness Score&lt;/th&gt;
&lt;th&gt;Rider/Athlete View&lt;/th&gt;
&lt;th&gt;Gardener View&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Low (&amp;lt; 0.3)&lt;/td&gt;
&lt;td&gt;Yes, go ride!&lt;/td&gt;
&lt;td&gt;Yes, water today&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Medium (0.3-0.6)&lt;/td&gt;
&lt;td&gt;Maybe, check conditions&lt;/td&gt;
&lt;td&gt;Maybe, check soil&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;High (&amp;gt; 0.6)&lt;/td&gt;
&lt;td&gt;No, too wet&lt;/td&gt;
&lt;td&gt;No, skip watering&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The engine calls this &lt;code&gt;EngineMode&lt;/code&gt;, either &lt;code&gt;wetnessConcern&lt;/code&gt; or &lt;code&gt;drynessConcern&lt;/code&gt;. A single enum that flips the entire interpretation layer while keeping the underlying moisture model identical.&lt;/p&gt;

&lt;p&gt;Yardwise (the gardening app) uses slightly shifted thresholds, 0.15 and 0.45 instead of 0.3 and 0.6, because the stakes of getting it wrong are lower. Missing a watering day is a mild inconvenience. Riding a muddy trail damages the trail. Playing softball on a muddy clay infield isn't great. You get the idea. &lt;/p&gt;

&lt;h2&gt;
  
  
  Why Not Just Show a Percentage?
&lt;/h2&gt;

&lt;p&gt;Early versions of the apps showed a moisture percentage, and it wasn't good. I didn't know what to do with "the trail is at 47% moisture." Is that rideable? It depends on the surface, on your own risk/comfort tolerance, on whether you care about trail damage, etc. A percentage pushes the decision back onto the user, which is exactly the problem the app was supposed to solve.&lt;/p&gt;

&lt;p&gt;The solution was to simplify down to three states: Yes/Maybe/No, with an explanation of &lt;em&gt;why&lt;/em&gt;. The Maybe state exists specifically for conditions where reasonable people would disagree. I have near me both public and private mountain bike trails, and the tolerance for mud varies widely based on level of traffic, so Maybe is when deferring to rider's judgement is actually correct. The engine shows you the contributing factors (temperature is helping, but humidity is holding things back, for example) so you can make the final call.&lt;/p&gt;

&lt;p&gt;Each verdict also carries a &lt;strong&gt;confidence level&lt;/strong&gt; (Low, Medium, High). Confidence drops when timing data is missing, when rain has been patchy and unpredictable, or when the wetness score lands right on a threshold boundary.&lt;/p&gt;

&lt;h2&gt;
  
  
  What's Coming in This Series
&lt;/h2&gt;

&lt;p&gt;If you find talk of drying multipliers and residual wetness scores riveting, then hold on to your butts! This is merely the first article in a series about building the Groundwise engine. Coming up:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Turning Raw Weather Into a Drying Model&lt;/strong&gt; - The math behind drying strength, residual wetness, and why rain intensity matters as much as total accumulation&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;One Engine, Three Apps&lt;/strong&gt; - How to structure a Swift package that serves multiple products with different surface libraries and threshold calibrations&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Edge Cases That Break Your Weather Model&lt;/strong&gt; - Freeze/thaw cycles, cold-weather plant dormancy, the surprising complexity of "is snow melting?", and dispatches from the great Nashville ice storm of 2026&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Flipping the Question&lt;/strong&gt; - How the Yardwise inversion works, including manual watering tracking and evaporative demand suppression&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Building Confidence Into Uncertain Verdicts&lt;/strong&gt; - Why three states beat a percentage, and how to communicate uncertainty without creating anxiety&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  The Apps
&lt;/h2&gt;

&lt;p&gt;The Groundwise engine powers three apps, all available for iOS:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;a href="https://stalefishlabs.com/apps/ridewise/" rel="noopener noreferrer"&gt;&lt;strong&gt;Ridewise&lt;/strong&gt;&lt;/a&gt;, ride conditions for trails, skateparks, bike parks, and pump tracks&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://stalefishlabs.com/apps/fieldwise/" rel="noopener noreferrer"&gt;&lt;strong&gt;Fieldwise&lt;/strong&gt;&lt;/a&gt;, field conditions for rec league sports on grass, turf, clay, and hard courts&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://stalefishlabs.com/apps/yardwise/" rel="noopener noreferrer"&gt;&lt;strong&gt;Yardwise&lt;/strong&gt;&lt;/a&gt;, watering guidance for casual gardeners with lawns, beds, and containers&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;All three are built by &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;, a small indie studio focused on simple tools for getting outside and doing things together.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;If you've built something that turns raw data into human decisions, I'd love to hear how you approached the threshold and confidence problem. Drop a comment or find us on &lt;a href="https://bsky.app/profile/stalefishlabs.bsky.social" rel="noopener noreferrer"&gt;Bluesky&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ios</category>
      <category>showdev</category>
      <category>sideprojects</category>
      <category>swift</category>
    </item>
    <item>
      <title>Building a Better Kicker: The Physics Behind the Jump Simulator</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Wed, 11 Mar 2026 05:00:30 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/building-a-better-kicker-the-physics-behind-the-jump-simulator-44gj</link>
      <guid>https://dev.to/stalefishlabs/building-a-better-kicker-the-physics-behind-the-jump-simulator-44gj</guid>
      <description>&lt;p&gt;Anyone who has ever flown through the air on two wheels can appreciate this: a rider staring at a jump and its gap, trying to picture the arc. How fast do I need to go? Will I clear it? Will the landing feel smooth or like a punch to the spine? The mental math is unreliable, the necessary intuition only gained with loads of experience, and the consequences of getting it wrong range from cuts and bruises to an ER visit and a stint on injured reserve.&lt;/p&gt;

&lt;p&gt;We built the &lt;a href="https://dev.to/experiments/jump-simulator/"&gt;Jump Simulator&lt;/a&gt; to replace that guesswork with real physics. It's a free, browser-based tool that lets BMX, MTB, and MX riders design gap jumps, simulate trajectories, and see exactly where (and how hard!) they'll land before moving a single shovel of dirt.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Problem with Gap Jump Design
&lt;/h2&gt;

&lt;p&gt;Gap jumps are deceptively simple: a takeoff ramp, empty air, and a landing ramp. Three elements. But each one hides a web of variables. The takeoff angle determines how much speed converts to height versus distance. The lip height sets the launch point above the gap floor, and with the landing height establish if you're working with doubles, a step-up, or an often dreaded step-down. The gap distance is the void you need to clear. The landing angle and height offset determine whether your wheels kiss the slope gently or slam into flat ground.&lt;/p&gt;

&lt;p&gt;Change any one variable and the entire trajectory shifts. A 5-degree steeper takeoff lip at the same speed can turn a clean landing into a 4-foot overshoot. A 2 mph drop in approach speed can leave you dangling over the gap's leading edge leading to a monster case.&lt;/p&gt;

&lt;p&gt;Experienced riders develop intuition for this, but intuition fails at the margins, and the margins are exactly where crashes happen.&lt;/p&gt;

&lt;h2&gt;
  
  
  Projectile Motion, With Drag
&lt;/h2&gt;

&lt;p&gt;At its core, the simulator solves a projectile motion problem, but not the textbook version. Once a rider leaves the lip, two forces act on them: gravity pulling them down, and air drag slowing them through the arc.&lt;/p&gt;

&lt;p&gt;The launch velocities are straightforward:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;vx = speed × cos(angle)
vy = speed × sin(angle)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Where gravity &lt;code&gt;g = 9.81 m/s²&lt;/code&gt; and &lt;code&gt;angle&lt;/code&gt; is the takeoff lip angle. In a vacuum, that's all you need, horizontal velocity stays constant, vertical velocity decays linearly. But at real-world speeds, air drag matters, especially for motorcycles carrying hundreds of pounds through the air at 40+ mph.&lt;/p&gt;

&lt;p&gt;The drag force at any instant is:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;F_drag = ½ × ρ × CdA × v²
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Where &lt;code&gt;ρ&lt;/code&gt; is air density (1.225 kg/m³), &lt;code&gt;CdA&lt;/code&gt; is the rider+vehicle's drag area, and &lt;code&gt;v&lt;/code&gt; is the current speed. The deceleration is &lt;code&gt;F_drag / mass&lt;/code&gt;, applied opposite to the velocity vector. Math nerdery aside, a heavier vehicle feels less deceleration from the same drag force. Or to put it even clearer, a lighter-weight BMX setup loses speed faster than a motorcycle at the same velocity.&lt;/p&gt;

&lt;p&gt;Because drag depends on velocity, which changes continuously, there's no clean closed-form solution. The simulator uses Euler numerical integration with a 0.0005-second timestep, updating position and velocity at each step. This produces a trajectory that's subtly different from a pure parabola, the arc is slightly asymmetric, with the descent steeper than the ascent. That's how real jumps work.&lt;/p&gt;

&lt;p&gt;What all this stuff is working toward, and where the complexity lies, is detecting &lt;em&gt;where&lt;/em&gt; on the landing ramp the rider actually touches down.&lt;/p&gt;

&lt;h2&gt;
  
  
  Landing Detection: Slope Geometry
&lt;/h2&gt;

&lt;p&gt;The landing ramp isn't a point, it's a sloped surface with a defined start, angle, and length. The simulator steps through the trajectory in 0.001-second increments, checking at each step whether the rider's position has crossed below the landing ramp's surface.&lt;/p&gt;

&lt;p&gt;The ramp surface is defined as a line from the gap's far edge, angled downward at the landing angle. At each timestep, the simulator compares the rider's y-position against the ramp's y-value at that x-position. When the rider crosses below the surface, we interpolate to find the precise landing point.&lt;/p&gt;

&lt;p&gt;This discrete stepping approach is more robust than solving the intersection analytically, because it handles edge cases gracefully, riders that land past the ramp, riders that never reach it, and riders that graze the lip on the way down. Sadly the simulator doesn't account for deliberate stylish nose taps at the lip on landing, but that doesn't mean you shouldn't do them!&lt;/p&gt;

&lt;h2&gt;
  
  
  The Verdict System
&lt;/h2&gt;

&lt;p&gt;So to rule a jump successful (safe!), landing on the ramp is necessary but not sufficient. A rider who lands on the ramp at a 45-degree descent angle when the ramp slopes at 25 degrees is going to be in for a rough time. The angle mismatch means the bike slams into the surface rather than matching it.&lt;/p&gt;

&lt;p&gt;The simulator classifies every jump into one of five verdicts:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Verdict&lt;/th&gt;
&lt;th&gt;Condition&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Clean&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Lands on ramp, descent angle within 15° of ramp angle&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Tight&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Lands on ramp but very close to the start or end (ratio &amp;lt; 0.15 or &amp;gt; 0.85)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Hard Landing&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Lands on ramp but descent angle mismatch exceeds 15°&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Short&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Lands before the ramp (didn't clear the gap)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Long&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Lands past the ramp (overshot)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The 15-degree tolerance is generous on purpose. Real-world suspension and body positioning absorb some mismatch. But beyond 15 degrees, even a skilled rider is going to feel it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Impact G-Force
&lt;/h2&gt;

&lt;p&gt;Beyond the verdict, the simulator estimates the G-force on landing. It calculates the component of the rider's velocity perpendicular to the landing ramp surface, the part that your body and suspension have to absorb, and converts it to a G-force estimate assuming a short deceleration window.&lt;/p&gt;

&lt;p&gt;This number is especially useful when comparing vehicle types. A motorcycle landing at the same trajectory angle as a BMX hits the ramp with more perpendicular velocity because of its higher approach speed, even if the descent angle matches the ramp perfectly. A "Clean" verdict with 4G of impact is a very different experience on a 25 pound BMX bike than on a 200+ pound dirt bike.&lt;/p&gt;

&lt;h2&gt;
  
  
  Three Vehicles, Three Physics Profiles
&lt;/h2&gt;

&lt;p&gt;BMX, MTB, and motorcycles ride fundamentally differently. A 20-inch BMX bike at 15 mph feels fast. A 27.5- or 29-inch mountain bike at 15 mph feels moderate. A 250cc dirt bike at 15 mph is barely rolling. The vehicles have different wheelbases, different masses, different drag profiles, and different speed envelopes.&lt;/p&gt;

&lt;p&gt;The simulator ships with three presets:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Parameter&lt;/th&gt;
&lt;th&gt;BMX&lt;/th&gt;
&lt;th&gt;MTB&lt;/th&gt;
&lt;th&gt;Moto&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Wheel diameter&lt;/td&gt;
&lt;td&gt;20"&lt;/td&gt;
&lt;td&gt;27.5"&lt;/td&gt;
&lt;td&gt;21"&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Wheelbase&lt;/td&gt;
&lt;td&gt;37"&lt;/td&gt;
&lt;td&gt;41"&lt;/td&gt;
&lt;td&gt;58"&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Mass (rider + vehicle)&lt;/td&gt;
&lt;td&gt;90 kg&lt;/td&gt;
&lt;td&gt;100 kg&lt;/td&gt;
&lt;td&gt;190 kg&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Drag area (CdA)&lt;/td&gt;
&lt;td&gt;0.40 m²&lt;/td&gt;
&lt;td&gt;0.45 m²&lt;/td&gt;
&lt;td&gt;0.65 m²&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Speed range&lt;/td&gt;
&lt;td&gt;5–25 mph&lt;/td&gt;
&lt;td&gt;8–30 mph&lt;/td&gt;
&lt;td&gt;15–55 mph&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gap range&lt;/td&gt;
&lt;td&gt;2–40 ft&lt;/td&gt;
&lt;td&gt;2–60 ft&lt;/td&gt;
&lt;td&gt;8–80 ft&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Unlike a simple projectile calculator, the presets &lt;em&gt;do&lt;/em&gt; change the physics. Mass determines how much air drag decelerates the vehicle mid-flight, a 190 kg motorcycle shrugs off drag that would noticeably slow a 90 kg BMX setup. The drag area (CdA) captures the vehicle's frontal profile: a motorcycle with a seated rider presents a larger surface to the air than a tucked BMX rider. Together, mass and CdA produce meaningfully different trajectories at the same launch speed and angle.&lt;/p&gt;

&lt;h2&gt;
  
  
  "Dial It In": The Optimizer
&lt;/h2&gt;

&lt;p&gt;The most useful feature isn't the physics or the visualization. It's a single button: &lt;strong&gt;Dial It In&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;When a rider has set up their ramp geometry but can't find a speed that yields a clean landing, the optimizer searches the full speed range for the current sport preset, evaluating the physics at each 0.5 mph increment. It collects every speed that produces a "Clean" verdict, then picks the one closest to the rider's current speed setting.&lt;/p&gt;

&lt;p&gt;If no speed in the range works, the ramp geometry is fundamentally incompatible, it goes further: adjusting the landing angle in 1-degree increments to find a viable configuration. The algorithm returns the smallest set of changes needed to make the jump work.&lt;/p&gt;

&lt;p&gt;This is the feature that saves trips to the ER. A rider can set up their dream gap, hit Dial It In, and immediately know whether the jump is achievable and exactly what speed to target.&lt;/p&gt;

&lt;h2&gt;
  
  
  Rendering: Canvas 2D, Not WebGL
&lt;/h2&gt;

&lt;p&gt;Anyone who ever played the old Stunt Cycle arcade game will appreciate this decision (yeah I'm aging myself, I know)...I deliberately chose Canvas 2D over Three.js or WebGL for this tool. The visualization is fundamentally two-dimensional, a side profile of the jump, and adding a third dimension would obscure the information riders actually need: trajectory shape, landing point, and angle matching.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/stuntcycle.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/stuntcycle.png" title="The Stunt Cycle arcade game used 2D side-to-side motorcycle jumps"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The rendering system uses a dynamic coordinate transformation that maps real-world feet/meters to canvas pixels. The scene auto-scales to fit the jump geometry, keeping the takeoff lip as the origin point and expanding the viewport as the gap distance or peak height grows.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Vehicle
&lt;/h3&gt;

&lt;p&gt;Each vehicle is drawn procedurally. The bicycles get two wheels, a frame, handlebars, and a standing rider silhouette. The motorcycle gets thicker tires, a swing-arm, front fork, engine block, exhaust pipe, seat, fenders, and a seated rider with a helmet and visor, legs bent down to the pegs instead of standing on pedals. During flight, the vehicle rotates naturally using the actual descent angle at each point in the trajectory:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;rotation = atan2(-vy, vx)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This produces the realistic nose-up-on-takeoff, level-at-peak, nose-down-into-landing motion that riders recognize from real footage.&lt;/p&gt;

&lt;h3&gt;
  
  
  Ghost Trails
&lt;/h3&gt;

&lt;p&gt;Every time a rider changes a parameter, the previous trajectory is saved as a ghost trail, a semi-transparent dashed arc that lingers for 2 seconds before fading. Up to three trails are kept simultaneously.&lt;/p&gt;

&lt;p&gt;Ghost trails are the key to iterative design. A rider can nudge the speed up by 1 mph and immediately see how the new arc compares to the old one. Without ghosts, each change exists in isolation. With them, the design process becomes visual diff.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Animation State Machine
&lt;/h2&gt;

&lt;p&gt;The simulator isn't just a static trajectory plotter, it animates the full jump sequence. The animation runs through four phases:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Approach&lt;/strong&gt;: The bike rolls up the kicker surface, following the curved ramp profile&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Flight&lt;/strong&gt;: Projectile motion through the air, following the calculated trajectory&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ride-off&lt;/strong&gt;: On a clean landing, the bike eases down the landing ramp for 1 second&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Crash&lt;/strong&gt;: On a miss, the bike freezes at the impact point with a red crash indicator&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Each phase transitions to the next based on position triggers, not timers. The approach phase ends when the bike reaches the lip. The flight phase ends when landing detection fires. The ride-off or crash phase runs for a fixed duration, then the animation holds on the final frame.&lt;/p&gt;

&lt;p&gt;Playback speed is adjustable from 0.25x to 2x, which is useful for studying the critical moment when the bike meets the landing ramp.&lt;/p&gt;

&lt;h2&gt;
  
  
  Kicker Geometry: The Radius Problem
&lt;/h2&gt;

&lt;p&gt;The takeoff ramp isn't a straight slope, it's a curved surface defined by a radius. The kicker radius determines how gradually the rider transitions from horizontal to the lip angle. A tight radius (small value) creates an abrupt, poppy kicker. A large radius creates a smooth, flowing ramp that's easier to ride but requires more speed to clear a similar gap as its poppier cousin.&lt;/p&gt;

&lt;p&gt;The simulator calculates the kicker radius automatically from the lip angle and lip height:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;radius = height / (1 - cos(angle))
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This is the same circular arc math used in skateboard ramp design, and it ensures the ramp profile matches real-world construction. The curve is rendered on the canvas as a series of line segments following the arc, giving riders an accurate picture of the ramp's shape and size.&lt;/p&gt;

&lt;h2&gt;
  
  
  What We Learned Building It
&lt;/h2&gt;

&lt;p&gt;So all the tech implementation details aside, we learned a few things while building this tool:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Landing angle matters more than distance.&lt;/strong&gt; The early prototype only checked whether the rider cleared the gap. Testers kept asking "why does this feel wrong?", the answer was always angle mismatch. Try jumping to flat in the real world and you'll feel this mismatch in your teeth! Adding the 15-degree tolerance check and the "Hard Landing" verdict transformed the tool from a distance calculator into an actual design tool.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Ghost trails were an afterthought that became essential.&lt;/strong&gt; Ghost trails became a need because the canvas flickered between parameter changes and revealed a lack of visual continuity. Once created, riders started using them to compare trajectories, and now they're the primary way to iterate on jump designs.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The Dial It In optimizer needed to be conservative.&lt;/strong&gt; Early versions would suggest radical changes, "increase speed by 12 mph and change the landing angle by 20 degrees." That's technically correct but useless. The final version minimizes the delta from the rider's current settings, making suggestions that feel like refinements rather than redesigns.&lt;/p&gt;

&lt;h2&gt;
  
  
  Try It
&lt;/h2&gt;

&lt;p&gt;The &lt;a href="https://dev.to/experiments/jump-simulator/"&gt;Jump Simulator&lt;/a&gt; runs entirely in your browser. No account, no install, no tracking. Pick your vehicle, dial in your ramp geometry, and simulate before you build. Let us know if it helps you, and feel free to recommend improvements. Send it!&lt;/p&gt;




&lt;p&gt;&lt;em&gt;The &lt;a href="https://dev.to/experiments/jump-simulator/"&gt;Jump Simulator&lt;/a&gt; is a free experiment from &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>science</category>
      <category>showdev</category>
      <category>sideprojects</category>
      <category>webdev</category>
    </item>
    <item>
      <title>The None Trap: Game Theory &amp; the Formula 1 DNF Pick</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Tue, 10 Mar 2026 05:02:45 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/the-none-trap-game-theory-the-formula-1-dnf-pick-55m5</link>
      <guid>https://dev.to/stalefishlabs/the-none-trap-game-theory-the-formula-1-dnf-pick-55m5</guid>
      <description>&lt;p&gt;When designing the DNF pick category for our fantasy racing mobile app &lt;a href="https://stalefishlabs.com/apps/openwheelers/" rel="noopener noreferrer"&gt;Open Wheelers&lt;/a&gt;, I included an option that felt generous: pick &lt;strong&gt;None&lt;/strong&gt;. If you believe nobody will retire from the race, select None and collect 2 points if you're right. Otherwise, pick a specific driver you think will be among the first three to retire, and earn 3, 2, or 1 points depending on how early they go out. We take our fantasy games seriously, I want them to be engaging and fun, and I care a lot about getting things right. So I decided to dig a bit deeper on this rule mechanic because it felt suspicious.&lt;/p&gt;

&lt;p&gt;On the surface, None looks like the smart play. I even worried perhaps it would become the ONLY play and break the game; I thought maybe everyone would figure out that None is the no-brainer pick to beat the system. After all, modern F1 cars are absurdly reliable. Races where every car finishes make headlines now instead of being unthinkable. So why not make None your weekly lock and bank the free 2 points?&lt;/p&gt;

&lt;p&gt;Because it's a trap. And the data proves it despite my instinct toward the opposite.&lt;/p&gt;

&lt;h2&gt;
  
  
  A decade of Did-Not-Finishes
&lt;/h2&gt;

&lt;p&gt;I looked at every F1 race from 2016 through 2024, 190 grands prix across nine seasons. Here's the reality of how often "nobody retires" actually happens:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Season&lt;/th&gt;
&lt;th&gt;Races&lt;/th&gt;
&lt;th&gt;Avg DNFs per race&lt;/th&gt;
&lt;th&gt;Zero-DNF races&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;2016&lt;/td&gt;
&lt;td&gt;21&lt;/td&gt;
&lt;td&gt;3.1&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2017&lt;/td&gt;
&lt;td&gt;20&lt;/td&gt;
&lt;td&gt;3.0&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2018&lt;/td&gt;
&lt;td&gt;21&lt;/td&gt;
&lt;td&gt;2.8&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2019&lt;/td&gt;
&lt;td&gt;21&lt;/td&gt;
&lt;td&gt;2.6&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2020&lt;/td&gt;
&lt;td&gt;17&lt;/td&gt;
&lt;td&gt;2.6&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2021&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;td&gt;2.1&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2022&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;td&gt;2.8&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2023&lt;/td&gt;
&lt;td&gt;22&lt;/td&gt;
&lt;td&gt;2.3&lt;/td&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2024&lt;/td&gt;
&lt;td&gt;24&lt;/td&gt;
&lt;td&gt;1.7&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Across the entire dataset, roughly &lt;strong&gt;12 out of 190 races&lt;/strong&gt; had zero retirements. That's about 6% of the time. Put another way, if you picked None for every race across a full decade, you'd be right once every 16 races. At 2 points per victorious pick, that means a steady None pick throughout an entire season would average a grand total of 3 points per season...yikes!&lt;/p&gt;

&lt;h2&gt;
  
  
  The math doesn't lie
&lt;/h2&gt;

&lt;p&gt;Let's compare two hypothetical players over a 24-race season like 2024:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Player A: The "None" loyalist&lt;/strong&gt;&lt;br&gt;
Picks None every single race. Correct twice. Season total: &lt;strong&gt;4 points&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Player B: The student of unreliability&lt;/strong&gt;&lt;br&gt;
Studies which teams are struggling with reliability or drivers who just seem to have a knack for finding the gravel, and targets those drivers. Even with modest accuracy, hitting a top-3 DNF just 5 times across 24 races, the floor is 5 points and the ceiling is 15 points depending on whether those picks land 1st, 2nd, or 3rd out.&lt;/p&gt;

&lt;p&gt;And 5 hits isn't ambitious. In 2023, Esteban Ocon and Logan Sargeant each retired from &lt;strong&gt;7 of 22 races&lt;/strong&gt;. In 2022, four different drivers, Zhou Guanyu, Valtteri Bottas, Carlos Sainz, and Fernando Alonso, hit 6 retirements each. If you identified any of those drivers early and kept picking them, you'd outscore None by a landslide.&lt;/p&gt;

&lt;h2&gt;
  
  
  But cars ARE getting more reliable
&lt;/h2&gt;

&lt;p&gt;This is true, and it's the one wrinkle worth watching. F1's finishing rate has climbed steadily from about 86% in 2016 to over 91% in 2024. The sport saw its first-ever consecutive zero-DNF races to open the 2024 season in Bahrain and Saudi Arabia.&lt;/p&gt;

&lt;p&gt;If that trend continues, and the 2026 regulations could easily reverse it, zero-DNF races might climb from 2-3 per season toward 4-5. Even at that rate, None at 2 points per hit would still max out at 8-10 points across a season, which a savvy driver picker can match by nailing just three or four retirements in the top-3 positions. It's worth noting that the opening race of 2026 had not only three DNFs but also two DNSs and one Lance Stroll driving the race effectively for test purposes since he pitted multiple times and ultimately finished with only 43 laps (the leaders did 58 laps). DNSs and turning a real race into a test are almost unheard of...so it's looking like 2026 may move us back toward the DNF mean instead of cementing a new age of reliability.&lt;/p&gt;

&lt;h2&gt;
  
  
  What this means for strategy
&lt;/h2&gt;

&lt;p&gt;Back to the None pick, I verified it isn't the safe move. It's the &lt;em&gt;passive&lt;/em&gt; move. It says "I don't want to think about this category." And passivity rarely wins in games with point differentials this tight.&lt;/p&gt;

&lt;p&gt;The real edge in the DNF category comes from paying attention to things most fantasy players ignore: which teams are running new and untested power units, which drivers have a reputation for aggressive racing that invites contact, and which cars have been nursing recurring mechanical issues across practice sessions.&lt;/p&gt;

&lt;p&gt;That's the kind of knowledge that separates pub-league champions from the field. And it's exactly the kind of informed, opinionated pick-making I built Open Wheelers around.&lt;/p&gt;

&lt;p&gt;So go ahead and pick None if you genuinely believe every car is making it to the checkered flag. Just know that the odds are about 15-to-1 against you.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;&lt;a href="https://stalefishlabs.com/apps/openwheelers/" rel="noopener noreferrer"&gt;Open Wheelers&lt;/a&gt; is a casual F1 and IndyCar fantasy game for friends, built by &lt;a href="https://stalefishlabs.com" rel="noopener noreferrer"&gt;Stalefish Labs&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>gamedev</category>
      <category>mobile</category>
      <category>showdev</category>
      <category>sideprojects</category>
    </item>
    <item>
      <title>Every Skateboarder's First Question, Answered With a Sticker</title>
      <dc:creator>Stalefish Labs</dc:creator>
      <pubDate>Sun, 08 Mar 2026 03:30:37 +0000</pubDate>
      <link>https://dev.to/stalefishlabs/every-skateboarders-first-question-answered-with-a-sticker-5k3</link>
      <guid>https://dev.to/stalefishlabs/every-skateboarders-first-question-answered-with-a-sticker-5k3</guid>
      <description>&lt;p&gt;The first thing a skateboarder asks when they roll up to a new ramp is some variation of the same question: "What's the tranny?"&lt;/p&gt;

&lt;p&gt;Not far behind: "How tall is it?" Then "How wide?" Then "What's the flat?" And if the ramp's owner is around, they answer. Again. For the hundredth time. Sometimes they don't remember the exact specs anymore. Sometimes they give a number that's close enough. Sometimes they just shrug and say "ride it and find out."&lt;/p&gt;

&lt;p&gt;BMX riders do the same thing, just with different priorities. And the questions aren't idle curiosity, they're practical. The dimensions of a ramp fundamentally change how it rides. A 5-foot mini with 8.5 feet of transition rides completely differently than a 5-foot mini with 7 feet of transition. One will feel mellow and flowy, the other steep and snappy and make it easier to lock certain tricks. Same height, totally different experience. Width determines how long you can cruise grinds and slides, or in the case of a vert ramp how many times you can switch directions on airs. Flat bottom determines how much speed you carry between walls and how much time you have to think between tricks. Coping style determines how grinds feel and whether your wheels are going to hang up. Surface material tells you how slick a ramp is, and whether you're about to have a smooth ride or a sketchy one.&lt;/p&gt;

&lt;p&gt;These aren't nerdy details. They're the spec sheet for the experience you're about to have.&lt;/p&gt;

&lt;h2&gt;
  
  
  The repetition problem
&lt;/h2&gt;

&lt;p&gt;If you've ever built a ramp, in your backyard, at a DIY spot, or for a local park, you know the drill. People show up, they're stoked, and they want to know what they're riding. You tell them. Then the next crew shows up and you tell them again. Your buddy brings a friend the following weekend and you tell them too. You post a clip online and the first comment is "specs?"&lt;/p&gt;

&lt;p&gt;It's not annoying, exactly. It's flattering that people care, and it's a totally valid question. But it's repetitive, and over time the numbers start to blur. Was the transition 7 feet or 7.5? Did you go with 14 feet of flat or 15? You built the thing three years ago and the napkin sketch is long gone.&lt;/p&gt;

&lt;p&gt;Park owners and ramp builders face this at scale. A skatepark might have a dozen features, each with different dimensions that riders want to know. The information exists, someone measured and cut every piece of wood or formed every piece of concrete, but it lives in a set of plans that nobody can find, or in the builder's head, or nowhere at all.&lt;/p&gt;

&lt;h2&gt;
  
  
  The nutrition label idea
&lt;/h2&gt;

&lt;p&gt;The solution hit me because of how obvious it is: a nutrition facts label, but for ramps.&lt;/p&gt;

&lt;p&gt;Everyone knows the format. You've seen it on every food package your entire life. It's a clean, standardized layout that packs a lot of specs into a small space. It's quickly scannable. It's familiar. And most importantly, it solves the exact same problem: conveying a set of important specs to someone who needs them, in a format they already know how to read.&lt;/p&gt;

&lt;p&gt;Instead of calories and protein, you get height and transition radius. Instead of serving size, you get rideable width. Instead of ingredients, you get surface material. Same structure, completely different domain, but the format transfers perfectly because the underlying need is the same: "tell me what I'm dealing with, quickly."&lt;/p&gt;

&lt;p&gt;Slap it up on the edge of the vert where nobody rides, or the side of the transition, even on the deck of the ramp by the coping. Now every skater who rolls up gets their questions answered before they even have to ask.&lt;/p&gt;

&lt;h2&gt;
  
  
  Building the generator
&lt;/h2&gt;

&lt;p&gt;That's the idea behind &lt;a href="https://dev.to/experiments/transition-facts/"&gt;Transition Facts&lt;/a&gt;, a tool in our Experiments section. You punch in the specs of your ramp — height, transition radius, width, flat bottom, coping type and diameter, surface material, and platform depth — and it generates a nutrition facts-style label that you can print as a sticker or a PDF.&lt;/p&gt;

&lt;p&gt;The design mimics the real FDA nutrition label closely enough that the format is instantly recognizable, but adapts the content entirely for ramp specs. The layout is intentionally dense in the way the original is — no wasted space, just the numbers that matter.&lt;/p&gt;

&lt;p&gt;It's a small tool. There's no account to create, no app to download. Enter your specs, print your label, stick it on your ramp. Done.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why it works
&lt;/h2&gt;

&lt;p&gt;The reason a sticker works better than just telling people is the same reason nutrition labels work better than asking the cashier what's in your food. The information is &lt;em&gt;there&lt;/em&gt;, at the point of use, every time, for everyone, without requiring anyone's time or memory.&lt;/p&gt;

&lt;p&gt;A ramp owner doesn't have to be present. A park doesn't have to staff someone to answer questions. A visiting skater doesn't have to feel weird asking. The specs are just &lt;em&gt;on the ramp&lt;/em&gt;, the same way ingredients are just on the box.&lt;/p&gt;

&lt;p&gt;And there's a secondary benefit: it settles arguments. "You sure that's only a foot and a half of vert?" "Feels more like 2 feet!" Now there's a label. Discussion over. Ride the ramp.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;&lt;a href="https://dev.to/experiments/transition-facts/"&gt;Transition Facts&lt;/a&gt; is a free tool in the &lt;a href="https://dev.to/experiments/"&gt;Stalefish Labs Experiments&lt;/a&gt; section. No account needed — just specs in, sticker out.&lt;/em&gt;&lt;/p&gt;

</description>
    </item>
  </channel>
</rss>
