Beginner Track

Use this track if this is your first production TUI with Tessera.

Goal

Ship one small but real app without learning every API first.

What to install

bash.sh

dotnet add package Tessera

That is enough for the normal public path.

Which project to start with

Start with a new net10.0 console app, then move through this order:

1. Installation
2. Quickstart (New App) or Quickstart (Existing App)
3. Your First App
4. Starter Examples
5. Flagship Evaluation

Learning order by problem

If your team is building:

• forms and data entry: read Inputs & Forms
• navigation-heavy shells: read Navigation & Workflow
• record-heavy investigations: read Data & Inspection
• dashboard/monitoring screens: read Dashboards & Plots

If you want one page per control with usage + properties + events, use Widget Pages.

Minimal app shape to remember

csharp.cs

using Tessera;
using Tessera.Controls;
using Tessera.Layout;

var app = TesseraApplication.CreateBuilder()
    .UseApp<OrdersApp>()
    .Build();

await app.RunAsync();

internal sealed class OrdersApp : TesseraApp
{
    public override TesseraEffect? Update(Message message) => null;

    public override Screen Build(ScreenContext context) =>
        Screen.Build(window => window.Body(body => body.Center(new Button { Text = "Open" }, 16, 3)));
}

What beginners usually miss

• keep app state in your TesseraApp
• use messages/effects for state transitions, not hidden side effects
• keep runtime configuration in builder setup
• start with primary Tessera namespaces first, then add Tessera.Core namespaces if you move into advanced runtime seams

Next step

Once this track feels stable, continue with Advanced Track.