🎨 ASCII Art Generator

🚀 A powerful web application for converting images and text into ASCII art, built with Next.js, React, and Tailwind CSS.

📑 Table of Contents

• Project Overview
• Features
• Architecture
• Installation
• Usage
• Contributing
• License

🌟 Project Overview

The ASCII Art Generator is a sophisticated web application that transforms images and text into captivating ASCII art. Built with modern web technologies, it offers an intuitive interface with extensive customization options, making it easy for users to create unique ASCII artworks.

Whether you're a digital artist, a programmer looking to add some flair to your console applications, or just someone who appreciates the aesthetic of ASCII art, this tool provides a seamless experience for generating, customizing, and exporting ASCII creations.

✨ Features

🖼️ Image Processing

• Image to ASCII Conversion: Upload any image and watch it transform into ASCII art in real-time
• Customizable Parameters: Fine-tune your ASCII art with adjustable settings for width, brightness, and contrast
• Real-time Preview: See changes instantly as you adjust settings, allowing for quick iterations

📝 Text Conversion

• Text to ASCII Art: Convert any text input into stylized ASCII art
• Multiple Character Sets: Choose from various character sets to achieve different visual styles
• Preset Styles: Quick access to predefined styles for instant artistic effects

🎯 User Interface

• Dark/Light Theme: Toggle between dark and light modes for comfortable viewing
• Responsive Design: Fully functional on desktop, tablet, and mobile devices
• Intuitive Controls: User-friendly interface with easy-to-understand settings

💾 Output Options

• Copy to Clipboard: Instantly copy your ASCII art for quick sharing
• Download as Text File: Save your creation as a .txt file
• Re-upload Functionality: Load previously generated ASCII art for further editing

🏗️ Architecture

🛠️ Technology Stack

• Next.js: Server-side rendering and efficient routing
• React: Dynamic and responsive user interface components
• Tailwind CSS: Utility-first CSS for rapid UI development
• TypeScript: Type safety and enhanced code quality

📐 Design Pattern

The application implements a component-based architecture, separating client-side and server-side logic for:

• Modular and reusable code
• Efficient state management
• Optimized performance

🚀 Installation

1. Clone the repository:

   git clone https://github.com/yllvar/create-ascii-art.git
   cd create-ascii-art
   

2. Install dependencies:

   npm install
   

3. Set up environment variables:

   • Copy .env.example to .env.local
   • Fill in required variables

4. Run the development server:

   npm run dev
   

5. Open http://localhost:3000 in your browser 🌐

📖 Usage

🖼️ Converting an Image to ASCII

1. Click "Upload Image" in the sidebar
2. Select an image file
3. Adjust width, brightness, and contrast
4. Watch your ASCII art update in real-time

✍️ Creating ASCII Art from Text

1. Switch to the "Text" tab
2. Enter your text
3. Select character set and style
4. Click "Generate"

🎨 Customizing Your ASCII Art

1. Try different presets
2. Fine-tune using advanced settings
3. Toggle dark/light mode as needed

💾 Exporting Your Creation

1. Copy to clipboard with one click
2. Download as a text file
3. Save for later editing

🤝 Contributing

We welcome contributions! Here's how:

1. Fork the repository
2. Create a new branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a pull request 🎉

Please read CONTRIBUTING.md for details on our code of conduct.

📄 License

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

🐛 Found a bug? Have a feature request? Open an issue