MapLibre Source Wiring

You have a tile URL or a data file and a style, and the map is blank, drawing at the wrong scale, or drawing in the wrong order. This skill covers connecting a source to a style correctly, and the failure modes that look identical from the outside.

When to Use This Skill

The source is already configured and the map is wrong in a way that produces no error. These are symptoms as you would observe them, before you know the cause:

• The map is blank, or a layer you added draws nothing, and the console is clean
• A custom style renders nothing against a tile source that works with the provider's own style
• The basemap is blurry, or sits at a different scale than everything drawn on top of it
• Data you added has covered the street names
• Icons are missing while the rest of the map draws fine
• Hover or click highlighting does nothing at all, and no error is raised
• You have a tile endpoint and are unsure which source type it needs, or whether to point url at its TileJSON instead of hand-writing tiles