You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+22-6Lines changed: 22 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,24 @@
1
1
# Animated GitHub Profile Studio
2
2
3
-
A browser-based editor for creating a personal GitHub profile README from one reusable configuration. Customize the text, animated terminal, featured repositories, skills, links, section order, colors, and motion settings, then export a ready-to-upload ZIP.
3
+
A browser-based editor for creating a personal GitHub profile README from one reusable configuration. Customize the design, fonts, text, animated terminal, featured repositories, images, GIFs, links, section order, colors, and motion settings, then export a ready-to-upload ZIP.
4
4
5
5
The built-in TFQ0 design remains the canonical example, but users no longer need to edit eight SVG files by hand.
6
6
7
+
## Design and media customization
8
+
9
+
Configuration v2 adds three focused customization systems:
10
+
11
+
- Four ready-made visual presets: Quality Control, Classic Terminal, Retro Arcade, and Anime HUD. They use generic interface elements and include no franchise characters, logos, or copied artwork.
12
+
- Curated font presets that map to controlled, SVG-safe font stacks rather than accepting arbitrary CSS.
13
+
- Structured remote media entries for images and GIFs referenced by HTTPS URL, with accessibility and attribution information kept alongside each entry.
14
+
15
+
Applying a visual preset changes presentation without replacing a user's profile text, repositories, links, or media. Loading a complete sample is a separate, confirmed action. Valid v1 configurations migrate automatically when imported or restored from browser storage.
16
+
7
17
## What it includes
8
18
9
19
- Live desktop and mobile preview in dark and light themes.
10
20
- Animated and reduced-motion/static SVG variants.
├── domain/profile.ts # strict versioned config and template metadata
56
66
├── generator/
57
67
│ ├── svg.ts # pure eight-variant SVG renderer
58
68
│ ├── readme.ts # GitHub README renderer
@@ -72,13 +82,19 @@ src/
72
82
- Drafts and the short-lived public repository cache stay in browser storage.
73
83
- Only public repository metadata is fetched directly from GitHub's public API.
74
84
- Generated SVGs contain no scripts, event handlers, remote fonts, external images, tracking, or live CI claims.
85
+
- User-selected media is referenced by HTTPS URL in the README rather than copied into the ZIP or embedded in the generated hero SVG.
86
+
- Previewing or viewing remote media may send an ordinary request to its third-party host. Remote content can disappear or change independently of the Studio.
75
87
- Static fallbacks are generated for visitors who prefer reduced motion.
76
88
- Custom Markdown blocks raw HTML and neutralizes non-HTTPS link destinations in generated output.
77
89
90
+
Users must own or hold permission for any media they add. Attribution alone does not grant permission, and adding media does not imply affiliation with or endorsement by its creator or rights holder. See [User content and third-party media notice](./USER_CONTENT_NOTICE.md).
91
+
78
92
## Legacy reference
79
93
80
94
The original hand-authored TFQ0 SVGs, screenshots, GIF, and `preview.html` remain in `assets/` and `preview/` as visual references. They are not used by the Studio build. New custom profiles should be generated through the editor so all responsive, theme, and reduced-motion variants stay synchronized.
81
95
82
96
## License
83
97
84
-
No license has been selected yet. Choose and add an appropriate license before inviting third parties to copy, modify, or redistribute the source.
98
+
Animated GitHub Profile Studio is released under the [MIT License](./LICENSE).
99
+
100
+
The MIT License does not grant rights to user-supplied content or third-party media. See [User content and third-party media notice](./USER_CONTENT_NOTICE.md).
Copy file name to clipboardExpand all lines: SETUP.md
+12Lines changed: 12 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,10 +21,14 @@ npm run build
21
21
22
22
These checks cover TypeScript, strict config parsing, all eight SVG variants, reduced-motion output, README-to-asset references, deterministic ZIP contents, unsafe input handling, public GitHub import errors, cache validation, and the WebMCP contract.
23
23
24
+
For the v2 configuration, verification also covers every design and font preset, migration of valid v1 drafts, structured remote-media validation and attribution, rejection of unsafe media URLs, and preservation of user content when applying a visual preset.
25
+
24
26
For a release, also inspect representative long content in desktop/mobile and dark/light previews. Design warnings are advisory because fixed SVG artwork cannot measure browser font metrics during generation.
25
27
26
28
The preview toolbar can download its currently selected SVG by itself. Use the Export panel's complete ZIP when publishing the full README and all responsive theme variants.
27
29
30
+
When changing the editor layout, inspect 1440 px, 1180 px, 900 px, 620 px, and 320 px viewport widths. Confirm that navigation and export actions remain reachable, keyboard focus remains visible, remote media stays within the preview, and no horizontal page overflow is introduced.
31
+
28
32
## Production output
29
33
30
34
`npm run build` creates the static site in `dist/`. The build uses relative asset paths and can be hosted at a domain root or a project subpath.
@@ -40,4 +44,12 @@ The editor's ZIP contains its own profile-specific `SETUP.md`. In summary:
40
44
3. Keep `profile.config.json` privately or in the repository if you want the profile to remain easy to edit.
41
45
4. Commit, visit the GitHub profile, and verify links, text wrapping, theme selection, and reduced motion.
42
46
47
+
Structured remote media is referenced by HTTPS URL and is not bundled in the ZIP. Previewing or viewing it can send a request to its host, and the content can later disappear or change. The user must own the media or hold the permissions needed to publish it; attribution alone does not grant permission. Adding media does not imply affiliation with or endorsement by a creator, platform, game, studio, publisher, or franchise. Review [USER_CONTENT_NOTICE.md](./USER_CONTENT_NOTICE.md) before publishing third-party material.
48
+
43
49
The animated terminal is decorative. It does not execute code or report live checks.
50
+
51
+
## License and release files
52
+
53
+
- Keep the standard [MIT License](./LICENSE) text unchanged.
54
+
- Keep [USER_CONTENT_NOTICE.md](./USER_CONTENT_NOTICE.md) with the release so the software license is not confused with rights to user-selected or third-party material.
55
+
- Built-in presets should use generic original design elements. Do not add third-party artwork or fonts without compatible permission and required notices.
Animated GitHub Profile Studio can reference user-selected images and animated media by HTTPS URL. The Studio does not acquire rights to that content and does not make an external work safe or lawful to use merely because it can be previewed or added to a generated README.
4
+
5
+
## Your responsibilities
6
+
7
+
You are responsible for ensuring that you own the media you add or have all permissions and licenses required to use, modify, display, and distribute it. This includes images and GIFs associated with games, animation, films, brands, artists, and other creators. You are also responsible for complying with applicable law, the media host's terms, GitHub's terms, and any required copyright, trademark, attribution, or license notices.
8
+
9
+
Attribution or a link to the source does not by itself grant permission. Do not imply that a rights holder, platform, game, studio, publisher, artist, or franchise sponsors, approves, or is affiliated with this project or with a generated profile unless that relationship is expressly authorized.
10
+
11
+
The built-in design direction is generic and original. Presets must not be understood as containing or licensing any franchise characters, logos, artwork, or other protected properties.
12
+
13
+
## Remote media behavior
14
+
15
+
Structured remote media is referenced by URL; it is not copied into the generated ZIP. Previewing the media in the Studio or viewing the generated profile may cause the browser or GitHub to request it from the third-party host. That host may receive ordinary request information, and its own privacy policy and terms apply.
16
+
17
+
Remote content can disappear, move, become unavailable, or change after a profile is generated. The Studio does not control the host, verify the media continuously, or guarantee its type, safety, accuracy, availability, or continued suitability.
18
+
19
+
## License separation
20
+
21
+
The repository's [MIT License](./LICENSE) applies to the Studio software and original project materials covered by that license. It does not license user-supplied content or third-party media, fonts, names, marks, or other materials. Referencing, previewing, exporting, or attributing third-party material does not transfer ownership or grant a sublicense.
22
+
23
+
## Disclaimer
24
+
25
+
To the maximum extent permitted by applicable law, the project authors and contributors are not responsible or liable for user-selected content, third-party hosts, broken or changed URLs, privacy practices of external services, infringement claims, or any loss or damage arising from the selection, use, display, distribution, or unavailability of remote media. You remain responsible for reviewing your generated profile before publishing it.
26
+
27
+
This notice is general project information, not legal advice.
0 commit comments