Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Sufianeh7/AmigoInvisible/llms.txt

Use this file to discover all available pages before exploring further.

Amigo Invisible lets any group organize a Secret Santa exchange in seconds. Add participants with names and emails, configure optional exclusion rules so certain people never gift each other, then launch the draw. Every participant receives a personalized email revealing only their assigned recipient — completely automated.

Quickstart

Run the full stack locally in under five minutes

Architecture

Understand how the Angular frontend and Node backend work together

API Reference

Explore the three REST endpoints that power every draw

Deployment

Deploy frontend and backend to Vercel with zero configuration

How It Works

1

Create a group

Enter a group name, an optional budget, and at least three participants (name + email). Set exclusion rules to prevent specific pairings.
2

Get your admin link

The backend generates a unique adminToken and returns an admin URL. Bookmark it — it is the only way to manage your group.
3

Review the list

Open the admin page to verify all participants are correct before the draw is irreversible.
4

Launch the draw

Click Realizar Sorteo. The algorithm pairs everyone up respecting all exclusions, then sends each person a private email revealing only their recipient.

Key Features

No Registration

Anyone can create a group with just an email address — no accounts, no passwords.

Exclusion Rules

Mark specific participants who must never be paired together (e.g., couples who already exchange gifts).

Automated Emails

Every participant gets a personalized HTML email through Gmail SMTP — the organizer never sees who got whom.

Retry Algorithm

The draw engine retries up to 1,000 times to guarantee a valid pairing even with complex exclusion sets.

Build docs developers (and LLMs) love