Docs › Team
Account

Team

A team is your cat-family: one owner, some admins, a bunch of plain members — all under one till. The Team screen is the family's control panel: invite a new cat by link, promote someone to admin, kick the one who left, and see how much the whole pack caught together.

The headline first, so you don't hunt for it later. In Lighter the team is teamlead-only. A team admin gets the full console; a plain member gets nothing — they don't even have a «Team» item in the menu. This is a deliberate decision, not a missing feature: on the platform most members have no team-level access anyway, so we didn't draw them half a broken screen. They just work, and their stats roll up to the teamlead.

Two roles, that's it. A team has exactly two levels: admin and member. No «managers», «supervisors», or other tiers. Don't invent access levels the platform lacks — they're absent on purpose.

The three screen states

What you see at /app/team depends on who you are:

  1. No team → the «Create or join» screen.
  2. You're an admin / owner → the full team console.
  3. You're a plain member who hit the URL directly → a short notice, and nothing else.

One at a time.

State 1 — No team: create or join

If you're not in any team yet, the screen offers two cards.

Workflow 1 — Create a team

  1. Open «Team». With no team, the item is visible to whoever is allowed to create or join.
  2. Type a name. In the Create a team card, enter a Name.
  3. Hit «Create». Done — you're the owner, and the screen reloads into the full console.
No «Create» card? Then team creation is switched off network-wide. Not a bug — just join by invite, or ask someone who already has a team.

Workflow 2 — Join by invite

  1. Get an invite. Your teamlead sends an invite link gang-join/{id}/{key} (or the id + key pair).
  2. Paste the link. Paste the whole link into the Join card's field — the id and key are extracted for you. Or enter the id and key separately.
  3. Hit «Join». The key is checked server-side; if it matches, you're in.
The invite link is the platform's classic gang-join/{id}/{key} route — it works for everyone, even people who haven't moved to Lighter yet. So you can pull anyone into the pack.

State 2 — The team console (admin / owner)

The teamlead's full console: team card, members, roles, invite, and danger zone on one screen.

The full console. A team card up top, a members table below, an invite panel and a «danger zone» to the side/below.

Team card. The team name and a Settings button — Settings edits only the name and description. Nothing else: Lighter carries no team visibility flags (see the gotchas below).

Members table. Columns: # · name · email · Role · contacts · stats → · actions.

Role is two levels: Owner + Admin, or Member. The «You» and «Owner» badges highlight the rows.

Invite panel.

The gang-join/{id}/{key} link, a Copy button with a «Copied» toast, and Reset key.

Danger zone. A Delete team button with a hard confirm: «Delete this team for everyone? This action is irreversible.» Deletion removes the team and detaches all members.

«Leave team» is disabled for admins. Owners and admins can't leave via Lighter — first remove your own admin rights, or delete the whole team. This matches the classic behaviour.

Workflow 3 — Invite to the team

  1. Open the «Invite» panel.
  2. Hit «Copy». Next to the gang-join/{id}/{key} link — you'll see a «Copied» toast.
  3. Send the link. Pass it to the new cat any way you like. They paste it into their Join card (Workflow 2) — and they're in the pack.
  4. (As needed) Reset the key. An old link leaked — hit Reset key, confirm «Reset the invite key? Old links will stop working.». The key rotates, every old link dies, so copy the new one.

Workflow 4 — Manage members

  1. Find the member's row in the table.
  2. Make admin / remove admin — click the row's role toggle. The role flips between Member and Admin.
  3. Kick — click Kick, confirm «Kick <name> from the team?». The member loses the team (their user_gang is zeroed), but their account stays intact.
The owner can't be kicked, demoted, or forced out. The buttons on the boss's row and on your own row are disabled. Want to disband the team? That's Delete team, not «kick the owner». By design.

Workflow 5 — Rename the team

  1. Click «Settings» in the team card.
  2. Edit the «Name» (and, if you like, the Description).
  3. Save. The header updates immediately; the edit round-trips to the same classic team backend.

Workflow 6 — View team data

  1. Drop into a member. In their row, click stats → to reach their numbers.
  2. See team-wide data in the reports. Team-wide stats live in Reports and Conversions — flip Scope there to Team, and the stats aggregate across the whole pack.
The Team screen and the «Mine / Team» switch are different things. The Team screen manages the roster (account-level) and doesn't depend on the data-scope switch. The Mine / Team switch itself lives in Reports and Conversions and only changes whose numbers you're looking at.

State 3 — Plain member (direct URL only)

You're a plain member. You have no «Team» item in the menu — the only way to reach this screen is by typing the address by hand. You'll then get a short notice along the lines of «You're in a team — it's managed by your teamlead», and that's all: no member list, no team data, no «Leave» button.

A member can't leave the team via Lighter. There's no «Leave» button in the SPA for you. Want out — ask your teamlead to kick you, or do it through the classic /gang interface. This isn't a designer's oversight, it's the same «team is teamlead-only» decision.

Good to know (the gotchas)

You're assembling your cat-family — invite the cats, hand out admin — but the boss cat can't be kicked, obviously. She was here first; the box is hers.

Coming from your old tracker

This is your old tracker's «Team» — the same users under one team. The invite link is the same team invitation you're used to. The difference is honesty: we don't draw members control panels they don't actually run — the teamlead steers the team, and the pack just catches profit.