Skip to content

A single-file simple image placeholder generator tool to create placeholder images for your projects and websites.

License

Notifications You must be signed in to change notification settings

arnonsang/image-placeholder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Image Placeholder Generator

Logo

License GitHub stars GitHub issues GitHub pull requests

A single-file simple image placeholder generator tool to create placeholder images for your projects and websites. This project is built with Go and Fiber

View Demo View API

FeaturesUsageInstallationAPITodoContributingAcknowledgmentsLicense

Screenshot

🌟 Features

  • 📋 Dynamic placeholder image generate via parameters and query
  • ✅ Supports custom width, height, and background color
  • 🌐 User-friendly web interface for easy testing and usage

🚀 Usage

API Endpoints

Method Endpoint Description
GET /readyz Health check endpoint
GET /:format/:width/:height/:text Generate a placeholder image with the specified width, height, and text

Parameters

Parameter Description Default
format Image format (png, jpg, jpeg)
width Image width in pixels 150
height Image height in pixels 150
text Text to display on the image width x height

Example

# Generate a 300x300 placeholder image with the text "Hello World"
https://placeholder.iamickdev.com/svg/300/300/Hello%20World

Web Interface

Access the intuitive web interface by navigating to placeholder.iamickdev.com

📝 TODO List

  • Add support for custom text
  • Add support for custom font size
  • Add support for custom font family
  • Add support for custom border radius
  • Add support for custom border size

💻 Installation

  1. Clone this repository:
git clone https://github.com/arnonsang/image-placeholder.git
  1. Navigate to the project directory:
cd image-placeholder
  1. Install the dependencies:
go mod tidy
  1. Start the server:
go run .
  1. Access the application at http://localhost:4000 in your browser or use the API endpoints directly.

📦 Dependencies

  • Go - The programming language powering the server
  • Fiber - Express-inspired web framework for Go
  • Tailwind CSS - A utility-first CSS framework for rapid UI development

🎉 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check issues page or open pull request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

We'd like to tip our hats to:

  • The awesome folks at favicon.io for their fantastic favicon generator. It's made our app look snazzy!

Your resources have been invaluable in making this project shine. Thank you! 🌟

Author

Made with ❤️ by iamickdev


About

A single-file simple image placeholder generator tool to create placeholder images for your projects and websites.

Resources

License

Stars

Watchers

Forks