Repository files navigation

Want your project to stand out?Socialify helps you showcase your project to the world by generating a beautiful project image like the one above!

It includes a ton of options including custom logo, description, badges, and many fonts and background patterns to choose from.

Join today!

Project site:https://socialify.git.ci

Click on the image to use the link anywhere, the image will be programmatically generated with live data. This means the badges will automatically update.

Recommended forREADME files orimg tags.

You can download the image as a.png,.jpeg or.webp and use it anywhere in the world!

Recommended for GitHub repositorysocial preview image and other sites that require image upload.

You can use cli toolmheap/github-social-image to upload social images to all your repos at once.

Please read and agree to ourContributor Covenant Code of Conduct to get started.

Run the following commands to get Socialify running locally:

# Clone your fork of wei/socialify if contributinggit clone https://github.com/wei/socialify.git&&cd$_# Set environment variables in .env.cp .env.example .env# Install dependenciespnpm install# Start local development serverpnpm dev

If you already have VS Code and Docker installed locally, you can also clickhere to get started. Clicking this link will cause VS Code to automatically install the Dev Containers extension if needed, clone the source code into a container volume, and spin up a dev container for use.

Socialify usesbiomejs as linter/formatter,Jest for unit testing, andPlaywright for end-to-end testing.

Make sure to run and pass the linter, unit and end-to-end tests locally before committing your code. Please let us know in case you need to update the test snapshots. More in"scripts" section in yourpackage.json file.

# Required: Set environment variables in .env.cp .env.example .env# Run linter/formatterpnpm lint# Fix linter/formatter errors# pnpm lint:fix# Run unit testspnpm test:unit# Install Playwright dependencies (first-time)# pnpm playwright:install# Run e2e testspnpm test:e2e

One changeset file is required per each PR.

1. Runpnpm changeset and select the appropriate senmantic versioning type (major, minor, patch) based on the scope of the change, together with an concise message.

2. You will see a new markdown file with a silly name likemilk-honey-eggs.md in the.changeset directory.

3. Test, commit, and push your codeWITH this changeset file when submitting a new PR.

4. You can manually edit it to include more information. For example:

   ---"socialify":minor---Added playwright e2e testing to capture user stories and main UI

That's it! We are tremendously grateful for your contribution to Socialify! ❤️

• @CryogenicPlanet
• @wei

Part of@MLH-Fellowship Pod 1.0.6

These are the heros who continue to make Socialify the best social preview generator for the community.

• MIT

Socialify is under active development. Design and project domain are subject to change without notice.

Please subscribe to#47 if you would like to receive service updates.

Consider downloading the images or self-hosting should this be a problem.

Socialify does not collect any personal or identifiable information, we do not use cookies, do not collect emails or anything.

Socialify uses Google Analytics on web pages to understand overall usage. Generated image links do not have any tracking.