Logo kit
One SVG logo → the complete kit to hand over to a client, made by logo_kit.py, which sits next to this
file. It renders with headless Chrome and needs no Python package on macOS.
Never make these files by hand: run the script, then look at the result.
Steps
- Find the source SVG of the full logo, and the SVG of the symbol alone (no text) if there is one. Only a PNG/JPG → stop: the logo has to be vectorized first; tell the user.
- Run it from the project root (under a minute).
<skill-dir>is the folder that holds this file:On Windows usepython3 <skill-dir>/logo_kit.py path/logo.svg --nom "Client Name" \ --symbole path/symbol.svg --nom-couleur goldpythoninstead ofpython3. - Look at
kit-logo/apercu.pngwith your image-viewing tool and check every row (see "What to check"). A defect → fix it with an option, run again with--ecraser, look at the preview again. - Deliver: open
kit-logo/apercu.htmlfor the user (openon macOS,xdg-openon Linux,starton Windows), then give the path of the zipkit-logo/<name>-kit-logo.zip.
Options
The options and the kit's folder names are in French: the kit is delivered as is to French-speaking clients.
| Option | Role | Default |
|---|---|---|
--nom | Brand name (file prefix, preview title) | required |
--symbole | Symbol alone: icons and profile pictures | the full logo |
--nom-couleur | Name of the original color version in file names (gold, blue…) | couleur |
--accent | Brand color: "accent" background, halo, choice of the readable variant | first color of the SVG |
--fond | Dark background of the visuals | #0a0a0a |
--sortie | Kit folder | ./kit-logo |
--ecraser | Replace an existing kit | refuses if the folder exists |
What the kit holds
| Folder | Content |
|---|---|
1-vectoriel | SVG original / black / white (logo and symbol), PDF original and black |
2-png-transparent | Logo at 1000, 2000 and 4000 px; symbol at 1000 and 2000 px; all 3 tints |
3-reseaux-sociaux | 8 formats (Instagram, story, Facebook, LinkedIn, X, 16:9) × 3 styles (dark, halo, light) + 4 profile pictures |
4-autres-usages | Solid backgrounds, icons 16 → 1024 px, watermark, email signature |
| root | apercu.html, apercu.png, the zip |
What to check in the preview
| What you see | Cause | Fix |
|---|---|---|
| Logo hard to read on a background, or wrong "accent" background | Multicolor logo: the SVG's first color is not the brand color | --accent "#rrggbb" |
| Black or white version is a solid blob, details gone | The logo uses white shapes or a mask to "cut out" | Tell the user: these versions need a dedicated one-color SVG |
| Logo text in another font | <text> not converted to paths (the script warned about it) | Convert the text to paths in the source SVG |
| Unreadable icons (wide logo squeezed into a square) | No --symbole | Ask for or extract the symbol alone, run again with --symbole |
Common mistakes
- Putting the kit in
public/: it would ship with the website. Leave it at the project root. - Saying "done" without looking at
apercu.png. The script checks sizes, not readability. - Using
--ecraseron a folder that is not a generated kit: look at what it holds first.
Requirements
- Python 3.9+ and Google Chrome, Chromium or Microsoft Edge (
CHROME=/path/to/chromeif it is not found). - Small sizes are scaled down with
sips(built into macOS); elsewhere with Pillow (pip install pillow) or ImageMagick.
The script checks itself with python3 <skill-dir>/logo_kit.py --test.