#!/usr/bin/env python3 """Generate a dependency-free static site from reviewed icon data. Python 3.12+.""" from pathlib import Path import json, re, html, hashlib, shutil, xml.etree.ElementTree as ET from string import Template from urllib.parse import quote ROOT=Path(__file__).resolve().parents[1] BASE='https://iconsforfree.com' ICONS=json.loads((ROOT/'data/icons.json').read_text()) ROADMAP=json.loads((ROOT/'data/icon-roadmap.json').read_text()) E=html.escape PUBLIC_FILES=set() categories=list(dict.fromkeys(i['category'] for i in ICONS)) def slugify(s):return s.lower().replace(' & ','-').replace(' ','-') def validate(): seen=set() allowed={'path':{'d'},'circle':{'cx','cy','r'},'ellipse':{'cx','cy','rx','ry'},'rect':{'x','y','width','height','rx','ry'},'line':{'x1','y1','x2','y2'},'polyline':{'points'},'polygon':{'points'}} for i in ICONS: assert re.fullmatch('[a-z0-9]+(?:-[a-z0-9]+)*',i['slug']) and i['slug'] not in seen, 'Invalid/duplicate slug' seen.add(i['slug']) assert i['name'] and i['category'] and i['description'] and isinstance(i['tags'],list) assert all(isinstance(t,str) for t in i['tags']) tree=ET.fromstring('') assert len(tree)>0 for child in tree: assert child.tag in allowed and not list(child) and not (child.text or '').strip(), 'Unsafe geometry' assert set(child.attrib)<=allowed[child.tag], 'Unsupported SVG attribute' for key,val in child.attrib.items(): pattern=r'[0-9eE+.,\sMmLlHhVvCcSsQqTtAaZz-]+' if key=='d' else r'[0-9eE+.,\s-]+' assert re.fullmatch(pattern,val), f'Unsafe SVG value: {val}' assert not (child.tail or '').strip() assert not (tree.text or '').strip() def svg(i,size=24,decorative=True): return f'' def glyph(name):return svg(next(i for i in ICONS if i['slug']==name)) def write(path,content): if not path.startswith('data/'):PUBLIC_FILES.add(path) target=ROOT/path;target.parent.mkdir(parents=True,exist_ok=True);target.write_text(content+'\n') def card(i): return f'{svg(i)}{E(i["name"])}' def inspector(i): return f'''''' def nav(): return f'''Skip to content''' def footer(): return '' def dialog(): return f'''''' def asset(path): return "/"+path+"?v="+hashlib.sha256((ROOT/path).read_bytes()).hexdigest()[:12] def page(title,desc,path,body,structured=None): canonical=BASE+path social_image=BASE+asset('assets/social/preview.png') social_alt=f'Icons for free: {len(ICONS):,} original customizable SVG icons, with a selection of line icons on a cobalt and white background.' schema=f'' if structured else '' return f'''{E(title)}{schema}{nav()}{body}{footer()}{dialog()}''' def catalogue(category=None): items=[i for i in ICONS if not category or i['category']==category] catnav='' for cat in ['All icons']+categories: count=len(ICONS) if cat=='All icons' else sum(i['category']==cat for i in ICONS) href='/' if cat=='All icons' else f'/categories/{slugify(cat)}/' symbol='grid' if cat=='All icons' else next(i['slug'] for i in ICONS if i['category']==cat) active=(cat==category or cat=='All icons' and not category) catnav+=f'{glyph(symbol)}{E(cat)}{count}' heading=f'{category} icons.' if category else 'Free icons. Made to be yours.' intro_text='Original line icons for whatever you’re making. Customize, copy, and carry on.' if category else f'{len(ICONS):,} original SVG icons. Customize color and stroke, then download SVG or PNG.' home_extras='' if category else '

No signupCC0 · No attribution requiredPNG up to 2048 px

' share_controls='' if category else '' return f'''

{E(heading)}

{E(intro_text)}

{home_extras}

{E(category or 'All icons')} {len(items)} icons

{''.join(card(i) for i in items)}

Same grid. Same stroke. Every icon belongs.Click an icon to customize

{inspector(items[0])}

A little SVG. A lot of freedom.

Change the color. Find your weight. Use it in a website, an app, or your next big idea.

A quick guide to using icons

<svg viewBox="0 0 24 24"\n     fill="none"\n     stroke="currentColor"\n     stroke-width="1.75">\n  <!-- Make it yours. -->\n</svg>

''' validate() for i in ICONS:write(f'icons/{i["slug"]}.svg',svg(i,24,False)) write('assets/icons-data.js','window.ICON_LIBRARY = '+json.dumps(ICONS).replace('<','\\u003c')+';') write('assets/favicon.svg','') write('index.html',page(f'{len(ICONS):,} free SVG icons · CC0 | Icons for free',f'Original icons for websites, apps and side projects. Customize colors and strokes. Download SVG or PNG up to 2048px. CC0, no attribution or signup.','/',catalogue(),{'@context':'https://schema.org','@type':'WebSite','name':'iconsforfree','url':BASE+'/'})) urls=['/','/guide/','/license/','/imprint/'] for cat in categories: path=f'/categories/{slugify(cat)}/';urls.append(path) write(path.strip('/')+'/index.html',page(f'{cat} SVG icons — free downloads | iconsforfree',f'Browse original {cat.lower()} outline icons. Adjust colors and stroke weight, then download SVG or PNG.',path,catalogue(cat))) for i in ICONS: path=f'/icons/{i["slug"]}/';urls.append(path) related=[j for j in ICONS if j['category']==i['category'] and j!=i][:5] body=Template((ROOT/'templates/icon.html').read_text()).substitute(slug=i['slug'],name=E(i['name']),lower_name=E(i['name'].lower()),category=E(i['category']),category_slug=slugify(i['category']),description=E(i['description']),tags=''.join(f'{E(t)}' for t in i['tags']),inspector=inspector(i),related=''.join(card(j) for j in related)) structured={'@context':'https://schema.org','@graph':[{'@type':'ImageObject','name':i['name']+' SVG icon','description':i['description'],'contentUrl':BASE+f'/icons/{i["slug"]}.svg','url':BASE+path,'encodingFormat':'image/svg+xml','width':24,'height':24,'license':'https://creativecommons.org/publicdomain/zero/1.0/','acquireLicensePage':BASE+'/license/','creditText':'iconsforfree — Line 01','creator':{'@type':'Organization','name':'iconsforfree'}},{'@type':'BreadcrumbList','itemListElement':[{'@type':'ListItem','position':1,'name':'Icons','item':BASE+'/'},{'@type':'ListItem','position':2,'name':i['category'],'item':BASE+'/categories/'+slugify(i['category'])+'/'},{'@type':'ListItem','position':3,'name':i['name'],'item':BASE+path}]}]} write(path.strip('/')+'/index.html',page(f'{i["name"]} SVG icon — free download | iconsforfree',i['description']+' Download free SVG, customize color and stroke width.',path,'

'+body+'

',structured)) for name,title,desc in [('guide','How to use and customize SVG icons','Learn to download, embed and customize original Line 01 icons.'),('license','CC0 1.0 public domain icons','Original Line 01 icons are dedicated to the public domain under CC0 1.0. Copy, modify and redistribute them without attribution.'),('imprint','Imprint / Impressum','Provider information and contact details for Icons for free, operated by Andreas Dittes in Berlin.')]: content=(ROOT/f'templates/{name}.html').read_text() write(name+'/index.html',page(title+' | iconsforfree',desc,'/'+name+'/',f'

{content}

')) for cat in ROADMAP['categories']: for item in cat['icons']: item['status']='available' if any(i['slug']==item['slug'] for i in ICONS) else 'planned' write('data/icon-roadmap.json',json.dumps(ROADMAP,indent=2)) write('404.html',page('Page not found | iconsforfree','This icon or page is not in the collection.','/404.html','

This one is missing.

The page may have moved, or the icon is not available yet.

Browse all icons

').replace('{BASE}/icons/{slug}.svg' sitemap+=f'{BASE}{url}{image}' write('sitemap.xml',sitemap+'') write('robots.txt','User-agent: *\nAllow: /\nSitemap: '+BASE+'/sitemap.xml') write('.nojekyll','') print(f'Built {len(ICONS)} validated SVGs, {len(categories)} categories, and {len(urls)} indexable pages.') # Only allowlisted public assets go into the deployment folder. public=ROOT/'dist' if public.exists():shutil.rmtree(public) public.mkdir() for path in PUBLIC_FILES | {'styles.css','tokens.css','app.js','CNAME','LICENSE-ICONS','assets/social/preview.png'}: target=public/path;target.parent.mkdir(parents=True,exist_ok=True) shutil.copy2(ROOT/path,target) print('Public-only deployment output: dist/ (project prompts, roadmap and docs excluded).')

Find your next icon

{E(heading)}

{E(category or 'All icons')} {len(items)} icons

No icons found.

A little SVG. A lot of freedom.

This one is missing.