branderson
c044f5e9cf
Game detail and play are one portal page: a stage with the screenshot and a Play button (or Enter) that loads the game in place, controls under it, details, plays, rating, tags, favorite and add to playlist, and related games.
97 lines
4.3 KiB
Markdown
97 lines
4.3 KiB
Markdown
# Discovery Portal
|
|
|
|
## Overview
|
|
|
|
The public pages use an arcade portal layout styled after 2010-era Flash game
|
|
sites, with a homepage built for discovery instead of lists of recent changes.
|
|
Account and admin pages keep the application layout.
|
|
|
|
## Shell
|
|
|
|
`PortalLayout` (`frontend/src/components/portal/`) wraps the homepage, browse,
|
|
game, player, favorites, playlists, downloaded and dashboard routes:
|
|
|
|
- A framed fixed-width page (1180px, desktop first)
|
|
- A wordmark built from the **Site Name** setting, with the optional **Tagline**
|
|
setting underneath
|
|
- Search, and a user menu holding the library, account and admin links and the
|
|
mature content switch
|
|
- Genre categories linking to browse by tag: Action, Adventure, Puzzle, Shooter,
|
|
Platformer, Sports, Strategy, Driving, Escape the Room and Dress Up, plus
|
|
Animations
|
|
- Keyboard shortcuts: `/` focuses search, `R` opens a random game
|
|
|
|
## Color Schemes
|
|
|
|
Portal colors are token sets in `components/portal/schemes.ts`. Each scheme sets
|
|
`--p-*` properties for the portal's own styles (`portal.css`) and overrides the
|
|
shadcn tokens (`--background`, `--primary`, ...) so shared components match. The
|
|
tokens are applied to `<body>` while the portal is mounted, which takes
|
|
precedence over the app theme on `<html>` and also reaches dialogs and menus
|
|
rendered into the body.
|
|
|
|
One scheme ships, **Chilled** (slate background, sage boxes). Adding a scheme
|
|
means adding an entry to `PORTAL_SCHEMES`; no component changes are needed.
|
|
|
|
Display text uses Fredoka (OFL, bundled via `@fontsource-variable/fredoka`);
|
|
body text uses Verdana.
|
|
|
|
## Homepage
|
|
|
|
- **Game of the Day:** the same pick for everyone on a given day, from the
|
|
Flashpoint curated playlists, with a link to the previous day's pick
|
|
- **Time Machine:** games released in a given week, starting from a random day
|
|
between 2005 and 2014. Users can step by week, jump to a random day, or click
|
|
the date to pick any day. "See all" opens browse filtered to that week. Only
|
|
games with a day-precise release date are included.
|
|
- **Jump back in:** the signed-in user's recently played games
|
|
- **Playlist shelves:** three random curated playlists with a sample of their
|
|
games
|
|
|
|
See the [Discovery API](../06-api-reference/discovery-api.md).
|
|
|
|
## Game Page
|
|
|
|
Game detail and play are one page (`views/GamePage.tsx`); the `/play` routes
|
|
open the same page with the game already started. Shared playlist links keep the
|
|
application's detail and player views.
|
|
|
|
- **Stage:** the game's screenshot with its logo and a Play button (or Enter).
|
|
Playing loads the game in place, starting a play session and fetching the game
|
|
data if needed. Saves, the Ruffle / original Flash Player switch and
|
|
Fullscreen sit under the game; in fullscreen the player's own header bar
|
|
returns. Platforms that can't run in the browser or be streamed point to the
|
|
Flashpoint Launcher.
|
|
- **About this game:** description, notes, and release date, developer,
|
|
publisher, series, platform, play mode and language; developer, publisher and
|
|
series link to browse.
|
|
- **Side boxes:** the signed-in user's plays of this game, the rating, and tags
|
|
linking to browse.
|
|
- **Favorite** and **Add to playlist** for signed-in users.
|
|
- **More like this:**
|
|
[related games](../06-api-reference/games-api.md#get-related-games).
|
|
|
|
## Default Ordering
|
|
|
|
Browse lists default to a shuffle instead of title order. The shuffle is seeded
|
|
and the seed is kept in the URL (`seed=`), so paging, back navigation and shared
|
|
links keep the same order; Reshuffle picks a new seed. Searches still default to
|
|
title order.
|
|
|
|
## Mature Content
|
|
|
|
Flashpoint's `extreme` game flag is not set in current metadata, so mature games
|
|
are identified the way the Flashpoint Launcher does: by the tag filter groups
|
|
marked `extreme` in `preferences.json` (falling back to
|
|
`.preferences.defaults.json`, then to the launcher's default groups:
|
|
Pornography, Fetishes, Violence, Bigotry and Pornography Extreme).
|
|
|
|
`MatureContentService` resolves those tags to game IDs once per database load.
|
|
Search, random, related games and discovery exclude them unless the request sets
|
|
`showExtreme=true`.
|
|
|
|
Users opt in with **Show mature games** in the user menu. The choice is stored
|
|
in the browser (`flashpoint-mature-content`), and for signed-in users also in
|
|
the account's `show_mature` setting, which is applied when they sign in on
|
|
another browser.
|