https://github.com/yllvar/create-ascii-art
A web application for converting images and text into ASCII art, built with Next.js, React, and Tailwind CSS. Upload Image or Use Text Base to Generate ASCII Art
https://github.com/yllvar/create-ascii-art
acsii-table art-generator
Last synced: 8 months ago
JSON representation
A web application for converting images and text into ASCII art, built with Next.js, React, and Tailwind CSS. Upload Image or Use Text Base to Generate ASCII Art
- Host: GitHub
- URL: https://github.com/yllvar/create-ascii-art
- Owner: yllvar
- Created: 2025-02-06T10:08:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-06T13:19:10.000Z (over 1 year ago)
- Last Synced: 2025-02-17T23:41:55.824Z (over 1 year ago)
- Topics: acsii-table, art-generator
- Language: TypeScript
- Homepage: https://get-ascii.vercel.app
- Size: 72.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎨 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](#project-overview)
- [Features](#features)
- [Architecture](#architecture)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#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:
```bash
git clone https://github.com/yllvar/create-ascii-art.git
cd create-ascii-art
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables:
- Copy `.env.example` to `.env.local`
- Fill in required variables
4. Run the development server:
```bash
npm run dev
```
5. Open [http://localhost:3000](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](CONTRIBUTING.md) for details on our code of conduct.
## 📄 License
This project is licensed under the MIT License - see [LICENSE.md](LICENSE.md) for details.
---
🐛 Found a bug? Have a feature request? [Open an issue](https://github.com/yllvar/create-ascii-art/issues)