Skip to content

Latest commit

 

History

History
166 lines (104 loc) · 9.5 KB

README.md

File metadata and controls

166 lines (104 loc) · 9.5 KB

GitHub Socialify

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 thousands of repositories today!

Usage

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

Social Image as a Service

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 for README files or img tags.

Image Download

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

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

CLI

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

Examples

Session Bot Example Class Photo Example Modfy Example Pull Example Traefik Example React Example

Contributing

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

Running Socialify Locally

Run the following commands to get Socialify running locally:

# Clone your fork of wei/socialify if contributing
git clone https://github.com/wei/socialify.git && cd $_

# Set environment variables in .env.
cp .env.example .env

# Install dependencies
pnpm install

# Start local development server
pnpm dev

Testing and Committing

Open in Dev Container

If you already have VS Code and Docker installed locally, you can also click here 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 uses biomejs as linter/formatter, Jest for unit testing, and Playwright 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 your package.json file.

# Required: Set environment variables in .env.
cp .env.example .env

# Run linter/formatter
pnpm lint

# Fix linter/formatter errors
# pnpm lint:fix

# Run unit tests
pnpm test:unit

# Install Playwright dependencies (first-time)
# pnpm playwright:install

# Run e2e tests
pnpm test:e2e

One changeset file is required per each PR.

  1. Run pnpm 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 like milk-honey-eggs.md in the .changeset directory.

  3. Test, commit, and push your code WITH 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! ❤️

Authors

Part of @MLH-Fellowship Pod 1.0.6

Community

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

License

Hosting

Deploys by Netlify

SLA

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.

Privacy

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.