How avgerinos8/ascii-art-web works
Ascii Art Web is a browser-based ASCII-art generator. A user submits text and font, layout, and color options; the Go server normalizes input, builds a render configuration, loads banner glyphs, and generates HTML output for the page or JSON response. The browser also supports live updates, HSL color-rule editing, background effects, layout controls, and saved settings. The README documents these capabilities; some frontend wiring and server routes are not visible in the sampled excerpts, so those relationships are not inferred.
Main entry points: main.go HTTP Server and Handlers · index.html Generator Page · font.go Banner Render Engine · fetch.js Live Requests
Components 18
Web Interface
- Generator Page
templates/index.html - Interface Styling
static/style.css - Live Requests
static/fetch.js - Color Rule Editor
static/colorPreview.js - Background Effects
static/bg.js - Setting Persistence
static/persistence.js - Scroll Synchronization
static/aScrollSync.js
HTTP Application
- HTTP Server and Handlers
main.go - Static Asset Service
main.go - Page Templates
templates
Rendering Engine
- Banner Render Engine
internal/font/font.go - Wrap and Align
internal/font/tokens.go - Color Conversion
internal/color/color.go - Font Banner Assets
banners
Input and Color
- Render Configuration
internal/arghandler/arghandler.go - Text Normalization
internal/normalize/normalize.go
Other components
- Browser User
- Browser LocalStorage
Connections 16
- Browser User → Generator Page: uses
README.md - Browser User → Live Requests: requests updates
README.md - Live Requests → HTTP Server and Handlers: sends live requests
README.md - HTTP Server and Handlers → Page Templates: renders page
main.go - HTTP Server and Handlers → Static Asset Service: serves static files
main.go - HTTP Server and Handlers → Render Configuration: builds configuration
main.go - Render Configuration → Text Normalization: normalizes text
internal/arghandler/arghandler.go - HTTP Server and Handlers → Banner Render Engine: creates and renders
main.go - Banner Render Engine → Font Banner Assets: reads glyphs
internal/font/font.go - Banner Render Engine → Wrap and Align: runs layout
internal/font/font.go - Wrap and Align → Color Conversion: converts colors
internal/font/tokens.go - Color Rule Editor → Live Requests: triggers updates
- Setting Persistence → Browser LocalStorage: saves and restores
static/persistence.js - Background Effects → Generator Page: adjusts effects
static/bg.js - Scroll Synchronization → Generator Page: synchronizes scrolling
static/aScrollSync.js - Interface Styling → Generator Page: styles