Token Reference

All tokens are passed inside the theme object to EPIS.init(). Every token is optional — omitted tokens are derived automatically or fall back to preset defaults.

Color tokens

Token	Type	Default (dark)	Default (light)	Notes
`primary`	hex / rgb	`#4f46e5`	`#4f46e5`	Main accent — buttons, links, highlights
`secondary`	hex / rgb	`#7c3aed`	`#7c3aed`	Supporting accent. Derived from `primary` (+30° hue) if omitted
`background`	hex / rgb	`#0f172a`	`#ffffff`	Outermost background of the embed
`surface`	hex / rgb	`#1e293b`	`#f8fafc`	Card and panel background
`surface2`	hex / rgb	`#263448`	`#f1f5f9`	Modals, dropdowns — double-elevated surface
`text`	hex / rgb	`#f1f5f9`	`#0f172a`	Primary text. Must pass 4.5:1 contrast on `background`
`textMuted`	hex / rgb	`#94a3b8`	`#64748b`	Secondary text, placeholders. Must pass 3:1 on `surface`
`border`	hex / rgba	`rgba(255,255,255,0.08)`	`rgba(0,0,0,0.08)`	Borders and dividers
`userBubble`	hex / rgba	`rgba(79,70,229,0.15)`	`rgba(79,70,229,0.08)`	User message background. Derived from `primary` at 15% / 8% opacity
`aiBubble`	hex / rgba	`rgba(255,255,255,0.04)`	`rgba(0,0,0,0.04)`	EPIS message background

Typography tokens

Token	Type	Default	Notes
`font`	string	`'Inter'`	Google Font name or `'system'`. Do not include fallback stack — SDK adds it automatically
`fontSize`	CSS length	`'15px'`	Base font size. Allowed range: `'13px'` – `'18px'`

Shape tokens

Token	Type	Default	Notes
`radius`	CSS length	`'12px'`	Primary border radius — cards, modals, large buttons
`radiusSmall`	CSS length	`'8px'`	Small border radius — chips, tags, inputs. Derived as ~60% of `radius` if omitted

Mode token

Token	Type	Default	Notes
`mode`	string	`'dark'`	`'light'` \| `'dark'` \| `'system'`. `'system'` follows OS `prefers-color-scheme`

Preset token

Token	Type	Notes
`preset`	string	`'dark'` \| `'light'` \| `'auraspace'` \| `'minimal'`. Applied as a base — individual token overrides win

What’s coming in v2

v1 keeps the token surface intentionally small so theming stays fast and predictable. A few things developers commonly ask about are on the roadmap:

What	Status
Chat bubble gradient	Roadmap — use flat `userBubble` for now
Custom shadow color	Roadmap
Per-component font size	Global `fontSize` covers most cases; per-component sizing coming
Custom animations	Out of scope — EPIS motion is intentionally consistent
Change the send button icon	Out of scope — UI chrome is not exposed

The “Powered by PastpaperLM” attribution inside the embed stays. It’s how your users know who powers the AI tutor they’re talking to — and it builds trust with them on your behalf. Think of it the way Vercel thinks about “Powered by Vercel”: attribution that carries weight.

Example: full custom theme

EPIS.init({
  clientId: 'your-client-id',
  theme: {
    // Colors
    primary:    '#3dd6c8',
    secondary:  '#4ba3f5',
    background: '#0d1b2a',
    surface:    '#1a2d3e',
    surface2:   '#24374a',
    text:       '#e8f4f8',
    textMuted:  '#8baab8',
    border:     'rgba(61, 214, 200, 0.15)',
    userBubble: 'rgba(61, 214, 200, 0.12)',

    // Typography
    font:     'Poppins',
    fontSize: '15px',

    // Shape
    radius:      '20px',
    radiusSmall: '12px',

    // Mode
    mode: 'dark',
  }
});

Get Started

Frameworks

SDK Reference

Theming

More

Token Reference

Color tokens

Typography tokens

Shape tokens

Mode token

Preset token

What’s coming in v2

Example: full custom theme

​Color tokens

​Typography tokens

​Shape tokens

​Mode token

​Preset token

​What’s coming in v2

​Example: full custom theme

Color tokens

Typography tokens

Shape tokens

Mode token

Preset token

What’s coming in v2

Example: full custom theme