Component App Basics (Beta)

Last Updated: June 2025

Important

If you have not already installed Tethys Platform, follow the Quick Start documentation and then return here.

This tutorial will teach you the basics of Tethys Component App development by walking you through the creation and development of a simple Component App using Tethys Platform. The finished app will be a GeoGlows API data viewer that enables a user to click on a map feature representing a river and generate a chart of the flow data associated with the clicked feature.

Tip

You will need to use the command line/terminal to manage your app and run the development server. It is highly recommended that you read the Terminal Quick Guide article for some tips if you are new to command line before you get started.

As a result of this tutorial, you will be familiar with the following concepts:

• Component App Project
• The App Class and Page Functions
• Components and Component-Based Development
• Event Handlers
• State
• User Experience (UX)
• Conclusion