---
title: "Add XP in an Afternoon: A Low-Maintenance Quickstart with Trophy"
canonical_url: "https://trophy.so/blog/add-xp-quickstart-low-maintenance"
description: "Add XP to your app in an afternoon with Trophy. Configure triggers in a dashboard, call one SDK method, and skip the custom points engine and its upkeep."
last_updated: "2026-08-05T13:21:16.000+00:00"
---

# Add XP in an Afternoon: A Low-Maintenance Quickstart with Trophy

Get XP live in your app by end of day by using Trophy's pre-built points systems. No custom points engine to build or maintain.

[Get started](https://app.trophy.so/sign-up) · [Read the docs](https://docs.trophy.so/features/points)

## What You Skip by Not Building It Yourself

Building XP in-house means point-inflation tuning, rebalancing award amounts, trigger logic, historical storage, and maintenance that continues indefinitely. Teams that build from scratch spend 3-6 months on implementation plus ongoing upkeep.

Trophy handles the infrastructure. You configure triggers in a dashboard, call one SDK method, and display the result. For the full build-vs-buy breakdown, see [How to Build an XP Feature](https://trophy.so/blog/how-to-build-an-xp-feature).

## Add XP in Three Steps

### Step 1: Create the XP System and Configure a Trigger

In the Trophy dashboard, create a points system called "xp" (or any name that fits your product). Add a metric-based trigger that awards XP when users perform an action.

Example trigger configuration:

-   **Metric**: `task_completed`
-   **Metric threshold**: 1 task
-   **Points awarded**: 10 points

No code deploy required. Change values in the dashboard and they apply immediately.

### Step 2: Track an Action and Read the Awarded XP

When a user performs the action, send a metric event to Trophy:

```typescript
import { TrophyApiClient } from '@trophyso/node';

const trophy = new TrophyApiClient(process.env.TROPHY_API_KEY);

const response = await trophy.metrics.event('task_completed', {
  user: { id: 'user-123' },
  value: 1
});

// XP awarded by this event
const xpAdded = response.points?.xp?.added;
const xpTotal = response.points?.xp?.total;

console.log(`+${xpAdded} XP. Total: ${xpTotal}`);
```

Trophy checks triggers, awards XP, and returns the result in the same response. No second API call needed.

### Step 3: Display the User's Total XP

Fetch the current total for display anywhere in your UI:

```typescript
const xp = await trophy.users.points('user-123', 'xp');

console.log(`Total XP: ${xp.total}`);
```

That's it. Three steps, one afternoon.

## Why It Stays Low-Maintenance

**Dashboard and MCP configuration**: Change point values, add triggers, or adjust thresholds without deploying code. Trophy's dashboard and [MCP support](https://docs.trophy.so/mcp/overview) let you iterate on your XP economy in minutes.

**Idempotent, retry-safe API**: If a request fails and your system retries, Trophy prevents double-awarding. No custom deduplication logic required.

**Rebalancing without disruption**: When you adjust point values, new events use new values while existing user XP stays unchanged. No migrations, no angry users.

## Get Started

[Campfire was set up in about an hour](https://trophy.so/customers/campfire). [Lexioo integrated in 3 days](https://trophy.so/customers/lexioo). Most teams ship XP in 1 day to 1 week, compared to 3-6 months building from scratch.

[Get started free](https://app.trophy.so/sign-up) · [Points documentation](https://docs.trophy.so/platform/points)