📋 Table of Contents

• Introduction
• Supported Image Formats
• Usage Examples
• Documentation
• Performance Considerations
• Contributing
• Useful Links

🌟 Introduction

Welcome to image-in-browser! This powerful NPM package allows you to effortlessly load, manipulate, and save images in a variety of formats, all within your browser or Node.js environment—no server-side setup required!

Key Features:

• Fully compatible with both Node.js and browser environments
• Developed entirely in TypeScript, compiled to JavaScript
• No external dependencies — lightweight and efficient
• A modern ES (ECMAScript) module for seamless integration

Whether you're working with static images or animated graphics, this library is perfect for projects where you want to keep your code isolated from the underlying system.

🖼️ Supported Image Formats

image-in-browser supports a wide range of image formats for both reading and writing:

Read / Write Formats:

• BMP
• GIF (including animated GIFs)
• ICO
• JPG
• PNG (including animated APNG)
• TGA
• PVR
• TIFF

Read Only Formats:

• PNM (PBM, PGM, PPM)
• PSD
• WEBP (including animated WEBP)

Write Only Format:

• CUR

💡 Usage Examples

Want to see image-in-browser in action? Check out our dedicated repository for practical examples and code snippets:

image-in-browser.examples (GitHub)

This repository will continue to grow, providing you with more examples over time.

📚 Documentation

For comprehensive documentation on how to use the package, please visit our Wiki.

⚙️ Performance Considerations

Please note that while image-in-browser is a versatile library, its performance may not match that of native libraries, as it is entirely written in TypeScript. Keep this in mind when planning your projects.

🧪 Testing

The project includes a comprehensive suite of tests to ensure functionality and reliability. To run the tests, use the following command:

npm run test:all

This will execute all test cases defined in the project.

🤝 Contributing

We believe that contributions are the heart of the open-source community! Your input can help make image-in-browser even better.

To contribute:

1. Fork the project
2. Create your feature branch (e.g., git checkout -b feature/AmazingFeature)
3. Important! Run npm run build to ensure your code meets project standards
4. Important! Address any errors or warnings that arise from your changes
5. Commit your changes (e.g., git commit -m 'Add some AmazingFeature')
6. Push to your branch (e.g., git push origin feature/AmazingFeature)
7. Open a Pull Request

Your support is greatly appreciated!

📜 License

This project is licensed under the MIT License. See the LICENSE.md file for details.

🔗 Useful Links

Check out our NPM repository for more information: