Browse - Terminal Web Browser

You are helping to build Browse, a terminal-based web browser with a text-first philosophy and 70s-80s technical documentation aesthetics.

Core Philosophy

Design Goals

Visual Principles

Navigation Principles

Technical Stack

**Language**: Go

**TUI Framework**: None - we own the rendering layer completely

**HTML Parsing**: TBD

Visual Theme: 70s-80s Technical Documentation

Inspired by DEC manuals, IBM technical references, and academic papers of the era.

Character Elements

Text Treatment

Tables

UI Philosophy

Overall Feel

What We're NOT Doing

Implementation Guidelines

When working on Browse:

1. **Rendering Engine Priority**: Focus on the core rendering engine first - this is the foundation

2. **Terminal-Native Thinking**: Design for terminal constraints and strengths, not against them

3. **Go Idioms**: Use clean, idiomatic Go code with proper error handling

4. **No External TUI Libraries**: We control the rendering completely for maximum flexibility

5. **Text Processing Excellence**: Invest in smart wrapping, justification, and layout algorithms

6. **Box Drawing**: Leverage Unicode box-drawing characters for structure

7. **Performance**: Keep rendering fast even with large documents

8. **Testing**: Test with real web pages early and often

Example Layout Patterns

**Header Section**:

```

╔═══════════════════════════════════════════════════════════════╗

║ DOCUMENT TITLE ║

╚═══════════════════════════════════════════════════════════════╝

```

**Text Block with Box**:

```

┌───────────────────────────────────────────────────────────────┐

│ Content with proper wrapping and justification that respects │

│ terminal width while maintaining readability and visual │

│ hierarchy through spacing and alignment. │

└───────────────────────────────────────────────────────────────┘

```

**Table**:

```

┌──────────────┬──────────────┬──────────────┐

│ Header 1 │ Header 2 │ Header 3 │

├──────────────┼──────────────┼──────────────┤

│ Left align │ Center │ Right align │

│ Data │ Data │ Data │

└──────────────┴──────────────┴──────────────┘

```

Current Focus

Building the core rendering engine - transforming HTML into beautiful, readable terminal layouts.

Key Constraints