{"id":16391500,"url":"https://github.com/rclement/business-card-generator","last_synced_at":"2025-03-16T16:31:11.948Z","repository":{"id":38084280,"uuid":"465491529","full_name":"rclement/business-card-generator","owner":"rclement","description":"Generate digital QR-code business cards","archived":false,"fork":false,"pushed_at":"2024-09-28T01:59:54.000Z","size":492,"stargazers_count":37,"open_issues_count":11,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-12T04:46:30.407Z","etag":null,"topics":["business-card-generator","flask","hcard","mecard","python","qrcode","segno","vcard"],"latest_commit_sha":null,"homepage":"https://business-card-generator.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rclement.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-02T22:40:06.000Z","updated_at":"2024-10-11T02:23:27.000Z","dependencies_parsed_at":"2023-02-14T06:46:12.521Z","dependency_job_id":"acbfee69-5813-4910-910f-4d570ba7e16e","html_url":"https://github.com/rclement/business-card-generator","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rclement%2Fbusiness-card-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rclement%2Fbusiness-card-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rclement%2Fbusiness-card-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rclement%2Fbusiness-card-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rclement","download_url":"https://codeload.github.com/rclement/business-card-generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243822283,"owners_count":20353499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["business-card-generator","flask","hcard","mecard","python","qrcode","segno","vcard"],"created_at":"2024-10-11T04:46:26.958Z","updated_at":"2025-03-16T16:31:11.634Z","avatar_url":"https://github.com/rclement.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Banner QR Card](https://business-card-generator.vercel.app/vcard.svg?firstname=Romain\u0026lastname=Clement\u0026picture=https%3A%2F%2Fromain-clement.net%2Fstatic%2Ficon.png\u0026company=Freelance\u0026job=Software+|+Data+|+AI\u0026email=contact%2Bgithub%40romain-clement.net\u0026phone=\u0026website=https%3A%2F%2Fromain-clement.net)\n\n# Business Card Generator\n\n[![CI/CD](https://github.com/rclement/business-card-generator/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/rclement/business-card-generator/actions/workflows/ci-cd.yml)\n[![Coverage Status](https://img.shields.io/codecov/c/github/rclement/business-card-generator)](https://codecov.io/gh/rclement/business-card-generator)\n[![License](https://img.shields.io/github/license/rclement/business-card-generator)](https://github.com/rmnclmnt/business-card-generator/blob/master/LICENSE)\n\nEveryone needs a business card. Or multiple ones. Or in multiple formats.\nMight as well be able to generate them on the fly.\n\nThis software allows to generate digital QR-code business cards:\n\n- [MeCard](https://en.wikipedia.org/wiki/MeCard_(QR_code))\n- [vCard](https://en.wikipedia.org/wiki/VCard)\n\n## Usage\n\nThe easiest way to generate a business card is to use the online\n[web application](https://business-card-generator.vercel.app).\n\nYou can also integrate URLs for website/keynotes integration using the following scheme:\n\n```\nhttps://business-card-generator.vercel.app/\u003ccard-type\u003e.\u003ccard-format\u003e?\u003ccard-parameters\u003e\n```\n\nAvailable card types:\n\n- `vcard`\n- `mecard`\n\nAvailable card formats:\n\n- `svg`\n- `png`\n- `vcf`\n\nAvailable card parameters:\n\n| Parameter   | Format                | Required | Description            |\n| ----------- | --------------------- | -------- | ---------------------- |\n| `firstname` | `string`              | Yes      | First name             |\n| `lastname`  | `str`                 | Yes      | Last name              |\n| `nickname`  | `str`                 | No       | Nickname               |\n| `birthday`  | `date` (`YYYY-MM-DD`) | No       | Birthday               |\n| `company`   | `str`                 | No       | Company name           |\n| `job`       | `str`                 | No       | Job title              |\n| `email`     | `EmailStr`            | No       | E-mail address         |\n| `phone`     | `str`                 | No       | Phone number           |\n| `website`   | `HttpUrl`             | No       | Website URL            |\n| `picture`   | `HttpUrl`             | No       | Picture URL            |\n| `street`    | `str`                 | No       | Street number and name |\n| `city`      | `str`                 | No       | City                   |\n| `zipcode`   | `str`                 | No       | Zipcode                |\n| `state`     | `str`                 | No       | State or region        |\n| `country`   | `str`                 | No       | Country                |\n\n## Deployment\n\nIf you do not trust the official deployment, feel free to deploy your own!\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/git/external?repository-url=https://github.com/rclement/business-card-generator)\n[![Deploy with Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/rclement/business-card-generator)\n\n## Development\n\n### Python\n\n```bash\ncp .example.env .env\npipenv install -d\npipenv shell\ninv qa\nflask run\n```\n\n### VSCode\n\nIf using VSCode, use the following configuration in `.vscode/launch.json`:\n\n```json\n{\n  \"version\": \"0.2.0\",\n  \"configurations\": [\n    {\n      \"name\": \"Python: Flask\",\n      \"type\": \"python\",\n      \"request\": \"launch\",\n      \"module\": \"flask\",\n      \"env\": {\n        \"FLASK_APP\": \"business_card_generator.app:create_app\",\n        \"FLASK_ENV\": \"development\"\n      },\n      \"args\": [\"run\", \"--no-debugger\"],\n      \"jinja\": true,\n      \"envFile\": \"\",\n      \"justMyCode\": false\n    },\n    {\n      \"name\": \"tests\",\n      \"type\": \"python\",\n      \"request\": \"test\",\n      \"justMyCode\": false\n    }\n  ]\n}\n```\n\n## Inspiration\n\n- [GitHub Readme Stats](https://github.com/anuraghazra/github-readme-stats)\n- [François Best Business Card](https://francoisbest.com/business-card)\n\n## License\n\nLicensed under GNU Affero General Public License v3.0 (AGPLv3)\n\nCopyright (c) 2022 - present  Romain Clement\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frclement%2Fbusiness-card-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frclement%2Fbusiness-card-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frclement%2Fbusiness-card-generator/lists"}