ssgoi
Official SSGOI skills for native app-like mobile web apps.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/meursyphus/ssgoi with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/meursyphus/ssgoi'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/meursyphus--ssgoi)HTML
<a href="/listings/meursyphus--ssgoi"><img src="/api/listings/meursyphus--ssgoi/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 28 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "ssgoi",
- "owner": {
- "name": "MeurSyphus",
- "email": "tmdeoans@snu.ac.kr"
- },
- "description": "Official SSGOI skills for native app-like mobile web apps.",
- "plugins": [
- {
- "name": "ssgoi",
- "source": "./plugins/ssgoi",
- "description": "Build mobile web app routing, layouts, and native app-like page transitions with SSGOI.",
- "author": {
- "name": "MeurSyphus",
- "email": "tmdeoans@snu.ac.kr"
- },
- "homepage": "https://ssgoi.dev",
- "repository": "https://github.com/meursyphus/ssgoi",
- "license": "MIT",
- "category": "development",
- "tags": [
- "mobile-web",
- "page-transitions",
- "animation"
- ]
- }
- ]
- }
README.md · README · 211 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # SSGOI
- Native app-like page transitions for mobile web apps, PWAs, and WebView apps.
- **Router agnostic · Cross-browser · SSR ready · Web Animations API powered**
- [Live showcase](https://ssgoi.dev) · [Documentation](https://ssgoi.dev/docs)
- | Drill | Sheet |
- | :---------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
- | <img src="./apps/docs/public/readme-drill.gif" alt="Drill transition opening and closing a chat in a mobile web app" width="280" /> | <img src="./apps/docs/public/blog/view-transition-api-limitations/sheet-blur-full.gif" alt="Sheet transition opening a compose screen above a mobile web app" width="280" /> |
- | Navigate through a mobile app with spatial depth | Present focused tasks above the current page |
- ## Why SSGOI?
- | | |
- | ---------------------------------- | --------------------------------------------------------------------------- |
- | **Router agnostic** | Keep your existing router and let it own navigation. |
- | **Cross-browser** | Use the same transitions across Chrome, Safari, Firefox, and Edge. |
- | **Optimized motion** | Spring physics are precomputed into Web Animations API keyframes. |
- | **Beyond the View Transition API** | Build transitions that need live DOM, runtime layers, and precise geometry. |
- | **Easy to adopt** | Add SSGOI by changing only two files. |
- ---
- ## Set it up with one link
- Give this URL to Claude, Codex, Cursor, or another coding agent:
- ```text
- https://ssgoi.dev/llms.txt
- ```
- It contains the full setup for React and Next.js, Svelte and SvelteKit, Vue and
- Nuxt, Solid and SolidStart, Angular, and Qwik.
- ---
- ## Or install the agent plugin
- The same `mobile-web-app` skill works in Codex and Claude Code.
- Codex:
- ```bash
- codex plugin marketplace add meursyphus/ssgoi
- codex plugin add ssgoi@ssgoi
- ```
- Claude Code:
- ```bash
- claude plugin marketplace add meursyphus/ssgoi
- claude plugin install ssgoi@ssgoi
- ```
- Then ask the agent to apply SSGOI to the current mobile web app. The skill reads
- the canonical `llms.txt`, selects the matching framework guide, and follows the
- app's existing router and layout structure.
- ---
- ## Or add it in just two files
- The Next.js setup is one config, one provider that knows how to read the
- Next.js route, and one ready-made layout boundary.
- ```bash
- npm install @ssgoi/react
- ```
- ```tsx
- // app/ssgoi-provider.tsx
- "use client";
- import { type ReactNode } from "react";
- import { usePathname, useSelectedLayoutSegments } from "next/navigation";
- import { Ssgoi, type SsgoiFramework } from "@ssgoi/react";
- import { drill } from "@ssgoi/react/view-transitions";
- const config = {
- transitions: [{ on: "/**", except: "/", transition: drill() }],
- };
- const INTERCEPTION_PREFIX = /^(?:\(\.\.\.\)|\(\.\.\)|\(\.\))+/;
- const framework: SsgoiFramework = {
- useRoute: () => {
- const pathname = usePathname();
- // The page the children slot renders. During a soft intercept it is still
- // the background page, so no background boundary moves.
- const segments = useSelectedLayoutSegments();
- if (pathname == null) return null;
- const renderedPath = `/${segments
- .filter((segment) => !(segment.startsWith("(") && segment.endsWith(")")))
- .map((segment) => segment.replace(INTERCEPTION_PREFIX, ""))
- .filter(Boolean)
- .join("/")}`;
- return { pathname, renderedPath };
- },
- };
- export function SsgoiProvider({ children }: { children: ReactNode }) {
- return (
- <Ssgoi config={config} framework={framework}>
- {children}
- </Ssgoi>
- );
- }
- ```
- Import the layout boundary from the same package. It takes no props: the first
- boundary reads the route for the ones inside it (and throws without a
- `framework`), and
- `renderedPath` keeps an intercepted modal's background in place:
- ```tsx
- import { SsgoiLayoutBoundary } from "@ssgoi/react";
- <SsgoiLayoutBoundary>{children}</SsgoiLayoutBoundary>;
- ```
- ```tsx
- // app/layout.tsx
- import { type ReactNode } from "react";
- import { SsgoiLayoutBoundary } from "@ssgoi/react";
- import { SsgoiProvider } from "./ssgoi-provider";
- export default function RootLayout({ children }: { children: ReactNode }) {
- return (
- <html lang="en">
- <body>
- <main className="relative z-0 min-h-dvh overflow-x-clip">
- <SsgoiProvider>
- <SsgoiLayoutBoundary>{children}</SsgoiLayoutBoundary>
- </SsgoiProvider>
- </main>
- </body>
- </html>
- );
- }
- ```
- The class string above is Tailwind shorthand. Without Tailwind, apply
- `position: relative; z-index: 0; min-height: 100dvh; overflow-x: clip` to the
- shell. Use `100vh` only where `dvh` is unsupported.
- That is enough for a simple app. `@ssgoi/react` never imports Next.js; it calls
- the `useRoute` hook you wrote. Other frameworks use the same small boundary
- model with their own router state passed as `framework`. For complete files,
- persistent layouts, nested boundaries, and framework-specific setup, see the
- [documentation](https://ssgoi.dev/docs/install). Upgrading from 7.x, where
- router subpaths such as `@ssgoi/react/nextjs` were still available? See the
- [8.0 migration guide](https://ssgoi.dev/docs/migration-v8).
- ---
- ## Compatibility
- SSGOI depends on the broadly available Web Animations API instead of requiring
- the View Transition API.
- | <img src="./apps/docs/public/logos/chrome.svg" alt="Chrome" width="36" /><br />Chrome 84+ | <img src="./apps/docs/public/logos/safari.svg" alt="Safari" width="36" /><br />Safari 13.1+ | <img src="./apps/docs/public/logos/firefox.svg" alt="Firefox" width="36" /><br />Firefox 75+ | <img src="./apps/docs/public/logos/edge.svg" alt="Edge" width="36" /><br />Edge 84+ |
- | :---------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------: |
- These are core Web Animations API runtime targets. The blur types in Sheet and
- Zoom also use `backdrop-filter` (Firefox 103+); earlier Firefox keeps the
- transition, scale, and dimming but omits the backdrop blur.
- The same build runs inside WebView shells — Capacitor, Ionic, Tauri, React
- Native WebView — and as an installed PWA, with no native plugin. iOS and Android
- back swipes are left to the OS.
- [Make a web app feel native →](https://ssgoi.dev/docs/native-app-feel)
- It observes the DOM lifecycle your framework already owns, so routing and SSR
- stay with your existing stack.
- | <img src="./apps/docs/public/logos/nextjs.svg" alt="Next.js" width="42" /><br />Next.js | <img src="./apps/docs/public/logos/react-router.svg" alt="React Router" width="42" /><br />React Router | <img src="./apps/docs/public/logos/tanstack.svg" alt="TanStack Router" width="42" /><br />TanStack Router | <img src="./apps/docs/public/logos/svelte.svg" alt="SvelteKit" width="42" /><br />SvelteKit | <img src="./apps/docs/public/logos/nuxt.svg" alt="Nuxt" width="42" /><br />Nuxt |
- | :-------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------: |
- React · Svelte · Vue · Solid · Angular · Qwik · framework-agnostic core
- An experimental [React Native / Expo Router integration](./packages/react-native/README.md)
- adds native `fade`/`slide` transitions with the same `SsgoiLayoutBoundary` naming.
- Try the [Expo template](./templates/expo) for the current implementation and device checks.
- [See complete compatibility and framework guides →](https://ssgoi.dev/docs/compatibility)
- Need the app screens too? [Comwit UI](https://library.comwit.io/ui) is a mobile
- app component kit built on SSGOI: app shell, app bar, bottom nav, bottom sheet,
- pull to refresh, and page transitions.
- ---
- ## Why SSGOI doesn't use the View Transition API
- SSGOI owns the geometry, temporary visual layers, live outgoing DOM, and
- navigation policy needed to turn complex motion into reusable presets.
- | Zoom | Film | Sheet |
- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------: |
- | <img src="./apps/docs/public/blog/view-transition-api-limitations/zoom-blur.gif" alt="Zoom transition that transforms and clips a detail page around its image" width="240" /> | <img src="./apps/docs/public/blog/view-transition-api-limitations/film.gif" alt="Film transition with runtime visual pieces and multiple springs" width="320" /> | <img src="./apps/docs/public/blog/view-transition-api-limitations/sheet-blur-full.gif" alt="Sheet transition with a live backdrop between two pages" width="240" /> |
- | The whole detail page unfolds from its image | Runtime scene, live video, and multiple springs | A live backdrop sits between the two pages |
- [Read why SSGOI doesn't use the View Transition API →](https://ssgoi.dev/blog/view-transition-api-limitations)
- ---
- ## License
- [MIT Licensed](./LICENSE) © [MeurSyphus](https://github.com/meursyphus)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.