📈 GH Trending Explorer 🎲 Surprise me

← all repos

metawka / expressive-profile

git clone https://github.com/metawka/expressive-profile.git v1.2.0 · today

Material 3 Expressive profile README generator for GitHub with daily auto-updates

—
stars, 24h
+39
stars, 7 days · #1,102
+39
stars, 30 days · #7,405
39
★ total · +39% this week
0
forks · 0 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageJavaScript
LicenseMIT
Created2026-10-17 (3d ago)
Last pushtoday
Watchers1
OwnerUser

GitHub topics

Links

README excerpt
# Expressive Profile
Generator of GitHub profile READMEs in the Material 3 Expressive style. The profile is set up on the site and installed into the profile repository. A GitHub Action then refreshes the stats every hour.
 Open the generator 
  · 
 Live example 
  · 
 GitHub Marketplace 
 Live cards from github.com/metawka , refreshed hourly by the Action. The look follows the GitHub light or dark theme. 
## Features
- Blocks: header, socials, about, tech stack, project cards, activity, streak, divider, link buttons.
- Live preview with editing by click, drag to reorder, hiding blocks.
- Material 3 color palette built from one color, a custom color or an image. Five palette styles, light and dark themes.
- Eight Material 3 shapes for the avatar, project cards and social icons.
- Typing animation for the subtitle and animations in every card. Animations can be turned off.
- Icon search across Material Symbols and Simple Icons.
- Templates, a shareable link to a setup and a "make one like this" page for any profile built with the generator.
- English and Russian interface.
## Screenshots
 Editor: live preview, editing by click, drag to reorder 
 Templates, main color and palette styles 
 Project cards from pinned or chosen repositories 
 Activity, streak and link buttons 
 Install to GitHub or download an archive 
 The "Made with Expressive Profile" link under a profile opens a page with its setup 
## Usage
1. Open the generator and enter a GitHub username.
2. Set up the blocks and press **Download**.
3. **Install to GitHub** signs in with a GitHub code, creates the profile repository and uploads the files.
https://github.com/user-attachments/assets/ad14524b-1529-4637-8612-7cb41c5eee35
Manual setup: **Download archive** gives a ZIP for a public repository named exactly like the username. All files from it are uploaded to that repository, including the `.github` and `.profile` folders.
Signing in uses the GitHub device flow with the `public_repo` and `workflow` scopes. The token stays in the browser tab and is used only for this upload. The sign-in proxy is open source, see `proxy/`. If the repository already has a README, the generator asks before replacing it.
The first workflow run replaces the preview data with exact stats and pinned repositories. Then the profile updates every hour and commits only when the data changes, plus once a day for the calendar.
To change the profile later, edit `profile.json` in the repository or set it up again on the site and upload the new `profile.json`.
## Made with Expressive Profile
- metawka
Profiles built with the generator can be added to this list with a pull request.
## Action
The archive contains this workflow:
 [code] 
| Input | Default | Description |
| --- | --- | --- |
| `token` | `github.token` | Token for the GitHub API |
| `commit-message` | `Updated profile` | Message of update commits |
With the default token the language chart counts public repositories only. Private repositories are counted wi