> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timeback.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Full-stack SDK for integrating Timeback into your application

The `@timeback/sdk` package provides everything you need to integrate Timeback into your web application:

* **Server adapters** for handling authentication and API routes
* **Client adapters** for React, Vue, Svelte, and Solid
* **Custom Activities** for tracking your own learning content
* **Managed Lessons** for delivering Timeback-powered assessments
* **Direct API access** to all Timeback services

## AI-assisted implementation

You can pair the SDK docs with focused skills for faster, reviewable implementation.

Use the [AI Skills page](/beta/build-on-timeback/ai/skills) as the canonical skill catalog. In most cases, run `/timeback-integrate` and let it invoke layer skills as needed.

For focused tasks, you can still run:

* [`/timeback-client`](https://github.com/superbuilders/timeback-sdk-skills/tree/main/skills/timeback/timeback-client) for client-side implementation
* [`/timeback-server`](https://github.com/superbuilders/timeback-sdk-skills/tree/main/skills/timeback/timeback-server) for server-side implementation

## Architecture

The SDK has two main components:

<CardGroup cols={2}>
  <Card title="Server" icon="server" href="/beta/build-on-timeback/sdk/server/nextjs">
    Handles authentication, SSO callbacks, and API proxying. Runs on your backend.
  </Card>

  <Card title="Client" icon="browser" href="/beta/build-on-timeback/sdk/client/react">
    Provides UI components, hooks, and learning features. Runs in the browser.
  </Card>
</CardGroup>

## Choose your path

The SDK supports two integration paths for learning content. Which one you use depends on who owns the content and learning logic.

<CardGroup cols={2}>
  <Card title="Custom Activities" icon="chart-line" href="/beta/build-on-timeback/sdk/activity-tracking/intro">
    You own your content. The SDK tracks time and reports completion metrics to Timeback.
  </Card>

  <Card title="Managed Lessons" icon="graduation-cap" href="/beta/build-on-timeback/sdk/managed-lessons/intro">
    Timeback runs the lesson engine. You render the UI and the SDK handles questions, scoring, and time tracking.
  </Card>
</CardGroup>

Not sure which to choose? See [integration levels](/beta/build-on-timeback/integration-levels) for a detailed comparison.

## Next steps

<CardGroup cols={2}>
  <Card title="Server Adapters" icon="server" href="/beta/build-on-timeback/sdk/server/nextjs">
    Set up server-side integration
  </Card>

  <Card title="Client Adapters" icon="browser" href="/beta/build-on-timeback/sdk/client/react">
    Add client-side components
  </Card>

  <Card title="Identity" icon="user" href="/beta/build-on-timeback/sdk/identity">
    Configure authentication
  </Card>

  <Card title="Custom Activities" icon="chart-line" href="/beta/build-on-timeback/sdk/activity-tracking/intro">
    Track your own learning content
  </Card>

  <Card title="AI Skills" icon="sparkles" href="/beta/build-on-timeback/ai/skills">
    Use setup, client, and server skills from one canonical page
  </Card>
</CardGroup>