CONSTELLATION FIELD GUIDE
What every section does
Constellation is built around a few different jobs: discovering creators you do not already follow, seeing who you follow live, finding creators near your own audience size, and keeping track of people you want to revisit. This guide explains the controls without making you decode the interface first.
Discover
Discovery Radar is the recommended starting point. It summarizes creators worth meeting, Creator Orbit, Category Opportunity, Emerging Signals, published Schedule Adjacency, Following rediscovery, and Nerdspace handoffs before you browse the full live directory.
Discovery Missions
Mission cards describe your goal instead of exposing ranking knobs. Meet Someone New keeps discovery broad. Find Hidden Gems prioritizes smaller live channels. Find My Community routes toward creators near your audience stage, tags, categories, and network signals. Scout Emerging Creators prioritizes bounded momentum/activity evidence. Outside My Bubble forces meaningful cross-category exploration while preserving explicit filters. Reconnect opens Following Signals. Find a Raid reuses Creator Match to find a live destination, then gives each live result visible Raid out actions: start the raid inside Constellation after an optional Twitch permission upgrade or copy the streamer name for a manual /raid username command.
Analyze a category
Expand Analyze a category inside Discovery Radar, search Twitch's category catalog, and run a bounded adaptive opportunity scan. Constellation shows demand, supply, demand-per-channel context, viewer concentration, creator fit, network evidence, and optional public historical context. Personal historical performance or future schedule opportunity stays labeled unavailable when Constellation has no evidence. Explore live creators turns the researched category into an explicit Discovery filter.
Creator Orbit & Find Similar
Creator Orbit groups current candidates into Inner, Adjacent, and Outer relationships. Find Similar uses Creator Network as a soft relationship model based on category relationships, tags, language, audience stage/scale, and local feedback; it does not silently convert the source creator into hard filters.
Browse modes
For You, Hidden Gems, Emerging, and Established remain available as secondary browse modes after the decision surfaces. Sort stays separate. Constellation uses adaptive candidate goals and safety ceilings rather than fetching the same fixed number of pages for every category.
Following
All, Live, Offline, and Clips are mutually exclusive buttons. All is built from Twitch's complete paginated followed-channel list, then enriched with public profile/channel/live metadata. Offline creators stay visible instead of disappearing just because they are not live. Discovery-only settings such as Partner exclusion, recently-seen suppression, creator stage, and Never show do not remove creators from this authoritative Following directory. When Twitch provides the follow timestamp, Constellation shows Following since … beside followed creators across the app.
Following Signals
Once the complete directory is warm, Constellation groups factual signals into Rediscover, New Follows, Changed Orbit, and Live Now. These use Twitch follow dates/current channel state plus Constellation-local interaction history. Constellation does not receive or infer Twitch watch history.
Twitch teams first
This option is off until you choose it. When enabled on Following Live, Constellation checks the Twitch teams each live followed creator belongs to. Team-affiliated creators are moved to the top of the list and their team name is shown in bold on the card. This uses Twitch's Channel Teams API and does not require another OAuth permission.
Turning the option off returns the list to its normal order and stops showing the team labels.
Creator Match 2.0
Creator Match finds potential peers or collaborators around an audience you control. The final audience number is always editable.
Audience source
Live now uses your current Twitch live viewers. 30D typical suggests your public TwitchTracker 30-day average. Last stream and Past broadcast load your archived Twitch VOD list but use the 30-day typical value only as a suggestion because Twitch VOD views are not live concurrent viewers. Custom lets you enter any audience directly.
Candidate audience basis
Live compares against what candidates have right now. 30D typical compares against TwitchTracker average viewers when available. Typical mode checks only a limited set of strong candidates.
Schedule Intelligence
Collaboration Fit first uses a creator's published Twitch schedule. If no schedule is published, Constellation can inspect up to 30 recent public archived broadcasts from the last 90 days and estimate recurring stream windows. Recent broadcasts count more strongly, very short broadcasts are ignored, and recurring start times are clustered so one unusual event does not become a fake schedule.
TwitchTracker does not supply per-stream timestamps. Constellation uses Twitch VOD timestamps for the observed pattern and uses TwitchTracker's public 30-day streamed-time total only as a completeness cross-check. If VOD history accounts for much less activity than TwitchTracker reports, confidence is reduced. Observed patterns are labeled High, Medium, Low, or Insufficient and are never presented as confirmed future availability.
Match tags
Required tags must all be present. Preferred tags improve ordering without excluding a creator. Excluded tags remove a creator. Your normal Discovery tags are still shown separately as useful overlap.
Shortlist, history, and expansion
Explicit Creator Match searches are saved locally in a small recent-history list. You can shortlist candidates, compare up to four creators, export the shortlist, or widen a thin match from ±50% to ±75% to ±100% and finally broaden the category search. These tools stay in browser storage only.
Match cards show Twitch tags and explain why the audience/tag relationship matched. Use TwitchTracker stats to open the creator's full public TwitchTracker profile in a new tab.
Saved
Saved is your local shortlist. Saving a creator does not follow them on Twitch and does not send them a notification. Collections can organize collaborators, games, communities, guests, or any other local workflow.
This section also exposes your private Constellation discovery profile and controls for resetting locally learned recommendation information.
Discovery filters
- Twitch tags: require at least one of the exact tags you selected or entered. Matching is case-insensitive.
- Preferred tags: add a small bounded recommendation preference without excluding creators that do not have them.
- Exclude tags: removes streams carrying any excluded tag.
- Language: limits results to a selected Twitch stream language.
- Audience size: sets minimum and maximum viewers. Audience basis can use current live viewers or a 30-day TwitchTracker typical audience when available.
- Maximum uptime: removes streams that have already been live longer than your selected limit.
- Recent creator activity: requires evidence of a recent archived broadcast. Creators with VODs disabled may not pass this check.
- 30-day activity: can require at least 10, 25, or 50 streamed hours from TwitchTracker.
- 30-day growth: can prefer/filter creators with recent follower growth or stronger growth efficiency relative to streamed hours.
- Exclude restricted chats: on by default. It removes follower-only, subscriber-only, and emote-only chats after checking the strongest candidates.
- Twitch classifications: selected classifications are requirements, not exclusions.
- Game genres: curated genre buttons resolve into real Twitch game categories.
- Game category: include or exclude specific Twitch categories by name.
Filters narrow who qualifies. The feed decides what kind of creator Constellation is looking for. Sort changes the order after creators qualify. You can save the current setup as a local preset or copy a shareable filter URL. Shared URLs contain filter choices only, not Twitch identity or OAuth data.
Creator cards
Details opens more Twitch information without immediately sending you away from Constellation. Save adds the creator to your local shortlist.
If you already follow the creator, Constellation can show Following since … using Twitch's followed-channel timestamp. The same cached follow-date lookup is reused on Discovery/Following cards, Creator Match, Saved, Compare, channel search, clips, and Details.
30-day context
Discovery cards may show Live now, 30d avg, 30d growth, and 30d active. These values come from TwitchTracker and are kept separate from Twitch's current live viewer count. Category context can also show the category's 30-day average viewers and average live channels when available.
More like this and Less like this teach optional local personalization. Follow category teaches Constellation that a game/category matters to you. Hide 30d temporarily suppresses a creator; Never show suppresses them until restored. Mark cycles through Maybe, Watch later, and Possible collab. Compare adds a creator to the up-to-four-person comparison tool. Creator Match cards also have a local Shortlist action.
Settings
Settings includes accessibility controls plus Discovery defaults such as creator stage, Partner exclusion, category variety, personalization, Historical Discovery context, and hiding recently seen creators.
Historical Discovery context
This is on by default and can be turned off. When enabled, Constellation enriches only a limited set of strong Discovery candidates with TwitchTracker 30-day channel summaries and a limited number of category summaries. The historical layer can improve audience-fit and Emerging/Hidden Gems context, while Twitch still remains the source for who is live and the current live viewer count.
Simple and Advanced
Simple mode keeps the four main destinations, the clearest discovery missions, and the primary actions in view. Advanced reveals browse modes, filters, category analysis, comparison, guided sessions, local data tools, detailed Creator Match sources, and diagnostics. Your choice is remembered on this device.
Personalization is local and optional. Explicit filters continue working even when personalization is disabled. Saved filter presets, Creator Match history, shortlists, bookmarks, and exports are also local-only in Alpha-0.26.0. Twitch login itself is maintained by an encrypted HttpOnly Worker session so Twitch access and refresh tokens are not exposed to browser JavaScript.
Troubleshooting
Open Diagnostics / Bug Log from Settings, the login footer, or the bottom of Constellation when something is not working. Constellation records a limited privacy-safe session log of runtime errors and sanitized request failures.
The downloaded .txt file includes the Constellation version, coarse browser/operating-system information, viewport size, the active section, filter counts, current scan totals, and sanitized request/error events. Twitch tokens, URL parameter values, chat text, and creator/channel identities are excluded.
Post the downloaded file in the #bug-reports channel in the Nerdspace Labs Discord and include a short description of what you clicked before the problem happened.
Data and privacy
Constellation uses your Twitch login and the permissions listed at login to read the data needed for its tools. Recommendation history, saved creators, filter presets, Creator Match history/shortlists, bookmarks, and preferences are designed to stay in your browser storage.
Twitch team lookups use the public broadcaster ID for live channels you follow and only run when you enable Twitch teams first. When Historical Discovery is enabled, Constellation sends only public Twitch channel logins and category IDs for a limited set of strong candidates through its same-origin Cloudflare proxy to TwitchTracker. Creator Match can separately request your own public channel summary for an editable 30-day audience suggestion, Typical candidate mode can request a limited set of candidate summaries, and Schedule Intelligence can request a candidate summary to cross-check whether the available public VOD history reflects their recent streamed-time total. Public summaries are cached for six hours to reduce repeated third-party requests. Your Twitch OAuth token is never sent to TwitchTracker.
The Diagnostics / Bug Log is local and optional. It stays in session storage until you clear it or the browser session ends, and it is never uploaded automatically. You decide whether to download or copy the sanitized report for support.
No D1 in Alpha-0.26.0. There is no Cloudflare D1 user database, background stream-history service, or cross-device sync in this release. Persistent cloud profiles and stream-history storage are reserved for the planned 3.0 architecture.