Skip to main content

Quick start

This guide shows you how to quickly install, configure and integrate Hyppot in your application.

Installation​

First, install the Hyppot.AspNetCore NuGet Package and one of the SQL providers NuGet packages: Hyppot.Sqlite, Hyppot.Sqlserver or Hyppot.Postgresql, depending on the DB engine of your choice:

dotnet add package Hyppot.AspNetCore
dotnet add package Hyppot.Sqlite

Configure​

In your Program.cs, define the authorization policy for accessing Hyppot administrative interface, then configure and register Hyppot using the following extension methods:

// Program.cs
using Hyppot.AspnetCore;
using Hyppot.Sqlite;

// ...

builder.Services.AddAuthorization(o => o.AddPolicy(HyppotConstants.DefaultAdminAuthorizationPolicyName, policy =>
    policy.RequireRole("Admin"))); // define authorization policy to require Admin role to access Hyppot panel

builder.Services.AddHyppot(config =>
{
    config.DbSetup = new SqliteDbSetup("Data Source=/app/storage/hyppot.db");

    // you can also use custom authorization policy
    // config.AdminAuthorizationPolicyName = "CustomPolicy";

    // or customize Hyppot path prefix instead of using the default '/hyppot'
    // config.PathPrefix = "/custom-path";
});

var app = builder.Build();

// ... 
// other app setup

app.UseHyppot();
app.Run();

Define your first experiment​

Now if you run the application and visit APP_URL/hyppot/panel, and log in with the appropriate user that fulfills the authorization policy, you should get the administrative interface with empty experiment list:

Admin interface

Great! You can start defining your first experiment:

First, extend the "Conversion Types Definition" section, add conversion types you would like to track and save them.

Then you can add your first experiment. Type the experiment name, click "Add". Then configure your experiment variables, define variants, set up the traffic split and click "Save".

Configured experiment

Integrate Hyppot in your application​

Select one of the available methods of integrating Hyppot in your application: Web experiments or backend-based Feature experiments:

Web experiments

Integrate Hyppot in your frontend with JavaScript/TypeScript

Feature experiments

Backend .NET Integration SDK

You can also combine both for more complex, multi-step experimentation and more reliable results tracking.

Activating the experiment and browsing results​

When you integrate the experiment in your code, you can Activate it in the Hyppot panel, making it available for your users.

After you gather some experimentation data, statistics will be available in a separate tab in the Hyppot panel:

Statistics

That's it! You've just configured and ran your first experiment.