# #

jawta - Signal Processing Application

jawta

LIVE - http://fornevercollective.github.io/jawta/terminal.html DEMO LIVE - http://fornevercollective.github.io/jawta/index.html DEMO

A comprehensive signal processing and intelligence application built with React and TypeScript, featuring dark theme UI with neon gradient effects, mobile-first design, and advanced communication capabilities.

Overview

jawta is a dual-interface signal processing application designed for both mobile walkie-talkie functionality and advanced desktop signal intelligence operations. The application supports text-to-audio conversion, Morse code processing, multi-band transmission, visual processing, and various communication protocols.

Key Features

🎯 Core Functionality

• Audio Processing: Text-to-audio, Morse code, 32-band equalizer, multi-band transmission
• Visual Processing: ASCII art, steganography, image-to-waveform conversion
• Communication: Optical internet, RF device integration, RFID/NFC support
• Radio Intelligence: Broadcasting, podcasts, streaming services integration
• Text Utilities: Mobile text patterns, encryption/decryption, language translation

🎨 Design System

• Dark Theme: Black background with neon gradient effects
• Mobile-First: 80px touch targets optimized for gloved users
• Responsive Design: Dual interface (simple mobile, advanced desktop)
• Navigation: Two-click maximum with slide-down quick access panel

📱 Interface Modes

• Mobile: Simplified walkie-talkie interface
• Desktop: Advanced signal intelligence dashboard with two-column layout
• Emergency: Quick access to critical communication functions

Technical Stack

• Frontend: React 18 + TypeScript
• Styling: Tailwind CSS v4.0
• UI Components: shadcn/ui component library
• Icons: Lucide React
• Build Tool: Vite
• Responsive: Custom hooks for device detection

Project Statistics

📊 Code Metrics (Estimated)

• Total Files: ~115 TypeScript/JavaScript files
• Total Lines: ~13,500+ lines of code
• Components: ~85 React components
• Utility Functions: ~7 utility modules
• UI Components: ~50 shadcn/ui components
• Pages: 6 main application pages

📁 Directory Breakdown

• Components: ~12,000 lines (85% of codebase)
• Utilities: ~1,200 lines (9% of codebase)
• Styling: ~450 lines (3% of codebase)
• Configuration: ~200 lines (1% of codebase)
• Documentation: ~400 lines (2% of codebase)

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn package manager
• Modern web browser with ES2020+ support

Installation

# Clone the repository
git clone https://github.com/fornevercollective/jawta.git
cd jawta

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Generate Actual Line Counts

To generate real line counts for the project:

# Count lines in TypeScript/JavaScript files
find . -name "*.tsx" -o -name "*.ts" -o -name "*.js" -o -name "*.jsx" | xargs wc -l

# Count lines by directory
find ./components -name "*.tsx" -o -name "*.ts" | xargs wc -l
find ./styles -name "*.css" | xargs wc -l

# Total project lines (excluding node_modules)
find . -path ./node_modules -prune -o -name "*.tsx" -o -name "*.ts" -o -name "*.css" -o -name "*.md" | grep -v node_modules | xargs wc -l

Usage Examples

Basic Signal Processing

import { SignalConverter } from './components/Signal/SignalConverter';

// Initialize with default settings
<SignalConverter 
  activeTab="signal"
  onTabChange={handleTabChange}
  isTransmitting={false}
  volume={75}
/>

Text to Morse Conversion

import { textToMorse } from './components/utils/textUtils';

const morse = textToMorse("HELLO WORLD");
// Output: ".... . .-.. .-.. --- / .-- --- .-. .-.. -.."

Mobile Touch Interface

// Touch targets automatically scaled to 80px minimum on mobile
<Button className="min-h-[80px] w-full">
  Emergency Transmission
</Button>

Contributing

1. Fork the repository
2. Create a feature 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

License

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

Changelog

See CHANGELOG.md for a detailed history of changes and version information.

---

jawta - Signal Processing & Intelligence Application
© 2025 - Built with React, TypeScript, and Tailwind CSS