This example showcases the APIs and conventions for using the file system as the primary way of creating pages. You should be able to accomplish most common tasks with this file-based API. If you want more control over the page creation you should use the createPages API.
In short, these APIs enable you to programmatically create pages from Gatsby's GraphQL data layer and to create client-only routes.
You can learn more in the documentation.