📝 Worded - Advanced Text Analysis & Formatting Tools

A powerful, feature-rich text manipulation and analysis tool built with React

Transform • Analyze • Format • Export

🚀 View Demo • 🐛 Report Bug • ✨ Request Feature

📖 About The Project

Worded is a modern, comprehensive web application designed to simplify text manipulation, analysis, and formatting. Whether you're a writer, developer, student, or content creator, Worded provides 30+ powerful tools to transform, analyze, and optimize your text with just a few clicks.

🎯 Perfect For

Writers & Authors: Analyze readability, word count, and improve your content
Developers: Format JSON, encode/decode Base64, and process code snippets
Students: Count words, check character limits, and format assignments
Content Creators: Optimize text, check similarity, and maintain consistency
Marketers: Analyze text statistics and create SEO-friendly content

✨ Why Choose Worded?

🚀 Lightning Fast: Real-time text processing with instant results
💾 Auto-Save: Your work is automatically saved every 2 seconds - never lose progress
🎨 Beautiful UI: Modern, clean interface with 7 customizable color themes
📊 Deep Analytics: Advanced readability scores, word frequency, and text statistics
🔒 Privacy First: All processing happens locally in your browser - your data never leaves your device
📱 Fully Responsive: Works seamlessly on desktop, tablet, and mobile devices
⌨️ Keyboard Shortcuts: Boost productivity with smart keyboard shortcuts (Ctrl+S to save, Ctrl+1/2/3 to switch tabs)
🌙 Dark Mode: Easy on the eyes with beautiful dark and light themes
📤 Export Options: Download as TXT, HTML, print, or email your documents

🚀 Key Features

📝 Text Editor (30+ Tools)

Case Conversion: Uppercase, lowercase, capitalize, title case, alternating case, camelCase
Text Alignment: Left, center, right, justify alignment
Find & Replace: Advanced text search and replacement with match highlighting
Text Manipulation: Reverse text, remove extra spaces, trim whitespace
Encryption: ROT13 encryption/decryption for text obfuscation
Text-to-Speech: Built-in speech synthesis to hear your text
Copy to Clipboard: One-click text copying
Draft Management: Save, load, and delete multiple text drafts
Word Wrapping: Wrap text at specific character lengths
Line Operations: Add line numbers, sort lines, remove duplicates

📊 Advanced Analysis Dashboard

Word & Character Count: Real-time detailed text statistics
Reading Time: Estimated reading time (200 words/min) and speaking time (150 words/min)
Readability Score: Flesch Reading Ease calculation for content optimization
Word Frequency Analysis: Top 10 most frequently used words with counts
Character Frequency: Detailed character usage breakdown
Text Statistics: Comprehensive metrics including sentences, paragraphs, lines, and average word length
Live Preview: See word count update as you type

🔍 Text Comparison

Similarity Analysis: Percentage-based text similarity
Common Words: Shared vocabulary between texts
Unique Words: Words unique to each text
Visual Comparison: Side-by-side text analysis
Statistics Comparison: Word and character count comparison

🛠️ Utility Tools

JSON Tools: Format (beautify) and minify JSON with syntax validation
Encoding/Decoding: Base64, hexadecimal, binary, URL encoding/decoding
HTML Tools: HTML escape/unescape for safe text rendering
Generators: UUID/GUID generation, hash generation (MD5, SHA)
Text Converters: ASCII to text, text to ASCII, and more
List Processors: Sort, shuffle, and deduplicate lists

💾 Save & Export Options

Auto-Save: Work is automatically saved to localStorage every 2 seconds
Draft Management: Save multiple drafts with custom names for later use
Export as TXT: Download your text as a plain text file
Export as HTML: Save formatted HTML documents
Print: Direct printing support with print preview
Email: Quick email integration to share your text

🎨 Themes & Customization

7 Color Themes: Blue, Red, Green, Yellow, Grey, Aqua, Black
Dark/Light Mode: Toggle between dark and light modes for comfortable viewing
Responsive Design: Optimized for all screen sizes (mobile, tablet, desktop)
Modern UI: Clean, intuitive interface with smooth animations
Persistent Settings: Your theme and mode preferences are saved

⌨️ Keyboard Shortcuts

Ctrl + S - Auto-save your current document
Ctrl + 1 - Switch to Text Editor tab
Ctrl + 2 - Switch to Text Comparison tab
Ctrl + 3 - Switch to Utility Tools tab
Ctrl + C - Copy text
Ctrl + V - Paste text

🛠️ Built With

Technology	Purpose
⚛️ React 18.2.0	Frontend framework for building UI components
🎨 Bootstrap 5	Responsive design and styling
🎯 React Icons 5.3.0	Icon library for modern UI elements
📄 jsPDF	PDF generation capabilities
🖼️ html2canvas	HTML to image conversion
🔧 Create React App	Development environment and build tools
💾 localStorage API	Client-side data persistence

📦 Installation & Setup

Prerequisites

Before you begin, ensure you have the following installed:

Node.js (v14.0.0 or higher) - Download here
npm (v6.0.0 or higher) - Comes with Node.js

Step-by-Step Installation

Clone the repository

git clone https://github.com/yourusername/worded.git
cd worded

Install dependencies
```
npm install
```
If you encounter peer dependency issues, use:
```
npm install --legacy-peer-deps
```
Start the development server
```
npm start
```
Open in browser

The app will automatically open at http://localhost:3000

If it doesn't open automatically, manually navigate to the URL in your browser.

🔧 Troubleshooting

Port 3000 already in use?

# On Windows
npx kill-port 3000

# On Mac/Linux
lsof -ti:3000 | xargs kill

Build errors?

# Clean install
rm -rf node_modules package-lock.json
npm install --legacy-peer-deps

🚀 Available Scripts

In the project directory, you can run:

`npm start`

Runs the app in development mode at http://localhost:3000

The page will reload when you make changes. You may also see lint errors in the console.

`npm test`

Launches the test runner in interactive watch mode.

`npm run build`

Builds the app for production to the build folder.

It correctly bundles React in production mode and optimizes the build for the best performance. The build is minified and filenames include hashes.

Your app is ready to be deployed!

`npm run eject`

Note: this is a one-way operation. Once you eject, you can't go back!

If you aren't satisfied with the build tool and configuration choices, you can eject at any time.

📱 How to Use

🔤 Text Editor

Navigate to the "Text Editor" tab (or press Ctrl+1)
Type or paste your text into the large text area
Use the formatting buttons to transform your text:
- Click "UPPERCASE" to convert all text to uppercase
- Click "lowercase" to convert all text to lowercase
- Click "Capitalize Each Word" for title case
- And many more options...
View real-time statistics in the dashboard below:
- Word count, character count, sentences, paragraphs
- Reading time and speaking time estimates
- Readability score
Use Find & Replace to search and replace text
Save your work as a draft for later use
Export your text as TXT or HTML, or print it directly

🔍 Text Comparison

Navigate to the "Text Comparison" tab (or press Ctrl+2)
Enter your first text in the left text area
Enter your second text in the right text area
Click "Compare Texts" to analyze
View the results:
- Similarity percentage
- Common words shared between both texts
- Unique words in each text
- Individual word and character counts

🛠️ Utility Tools

Navigate to the "Utility Tools" tab (or press Ctrl+3)
Choose a tool category:
- JSON formatting/minification
- Base64 encoding/decoding
- URL encoding/decoding
- UUID generation
- And more...
Enter your input text
Click the corresponding action button
Copy the output to your clipboard

🎨 Customization

Changing Themes

Click on the "Themes" dropdown in the navigation bar
Select your preferred color:
- Blue: Professional and clean
- Red: Bold and energetic
- Green: Calming and natural
- Yellow: Bright and cheerful
- Grey: Neutral and balanced
- Aqua: Fresh and modern
- Black: Dark and sophisticated

Toggle Dark/Light Mode

Use the toggle switch in the navigation bar
Your preference is automatically saved for your next visit

🎯 Use Cases

Content Writing: Track word count, analyze readability, and format text
Academic Writing: Meet word/character limits, check statistics
Social Media: Count characters for tweets, format captions
Programming: Format JSON, encode/decode Base64, process strings
Email Writing: Format and analyze email content before sending
Document Editing: Clean up text, remove extra spaces, fix formatting
Text Analysis: Compare documents, find similarities, analyze frequency
Quick Notes: Save drafts, auto-save prevents data loss

� Project Structure

worded/
├── public/
│   ├── index.html          # Main HTML file
│   ├── manifest.json       # PWA manifest
│   └── worded-logo.svg     # Application logo
├── src/
│   ├── components/
│   │   ├── Alert.js        # Alert notification component
│   │   ├── Navbar.js       # Navigation bar with themes & help
│   │   ├── TextForm.js     # Main text editor component
│   │   ├── TextComparison.js  # Text comparison tool
│   │   └── UtilityTools.js    # Utility tools collection
│   ├── App.js              # Main app component with routing
│   ├── App.css             # App-specific styles
│   ├── ModernUI.css        # Custom modern UI styles
│   ├── index.js            # React entry point
│   └── index.css           # Global styles
├── package.json            # Project dependencies
└── README.md              # This file

🔒 Privacy & Security

✅ 100% Client-Side: All text processing happens in your browser
✅ No Server Requests: Your data never leaves your device
✅ No Tracking: No analytics, cookies, or tracking scripts
✅ No Account Required: Use the app without signing up
✅ localStorage Only: Data saved locally on your device
✅ Open Source: Review the code yourself

Your privacy is our priority. Worded is designed to work entirely offline after the initial load.

🚀 Deployment

Deploy to GitHub Pages

Update package.json with your repository:

"homepage": "https://yourusername.github.io/worded"

Install gh-pages:
```
npm install --save-dev gh-pages
```

Add deployment scripts to package.json:

"scripts": {
  "predeploy": "npm run build",
  "deploy": "gh-pages -d build"
}

Deploy:
```
npm run deploy
```

Deploy to Vercel

Install Vercel CLI:
```
npm install -g vercel
```
Deploy:
```
vercel
```

Deploy to Netlify

Build your app:
```
npm run build
```
Drag and drop the build folder to Netlify

🤝 Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

How to Contribute

Fork the Project
Create your Feature Branch
```
git checkout -b feature/AmazingFeature
```
Commit your Changes
```
git commit -m 'Add some AmazingFeature'
```
Push to the Branch
```
git push origin feature/AmazingFeature
```
Open a Pull Request

Contribution Guidelines

Write clear, concise commit messages
Follow the existing code style
Test your changes thoroughly
Update documentation as needed
Add comments for complex logic

🐛 Bug Reports & Feature Requests

Found a bug or have an idea for a new feature?

Bug Reports: Open an issue
Feature Requests: Open an issue

Please provide as much detail as possible to help us understand and address your concern.

📝 Roadmap

📄 License

Distributed under the MIT License. See LICENSE file for more information.

This means you can:

✅ Use commercially
✅ Modify
✅ Distribute
✅ Private use

👨‍💻 Author

Your Name

🙏 Acknowledgments

Special thanks to:

Create React App - For the amazing React toolchain
Bootstrap - For the responsive CSS framework
React Icons - For the beautiful icon library
jsPDF - For PDF generation capabilities
html2canvas - For HTML to canvas conversion
All contributors who help improve this project

💖 Support

If you find this project helpful, please consider:

⭐ Starring this repository
🐛 Reporting bugs or suggesting features
📢 Sharing with others who might find it useful
🤝 Contributing to make it even better

📞 Support & Contact

Need help or have questions?

📖 Check the Documentation
🐛 Open an Issue
💬 Discussions
📧 Email: support@worded.com

⭐ Star this repo if you find it useful!

Made with ❤️ using React

Worded - Your comprehensive text analysis and formatting companion! ✨

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
.vscode		.vscode
public		public
src		src
.gitattributes		.gitattributes
.gitignore		.gitignore
GITHUB_SETUP.md		GITHUB_SETUP.md
README.md		README.md
netlify.toml		netlify.toml
package-lock.json		package-lock.json
package.json		package.json

rahilshah3105/TextUtils

Folders and files

Latest commit

History

Repository files navigation

📝 Worded - Advanced Text Analysis & Formatting Tools

📖 About The Project

🎯 Perfect For

✨ Why Choose Worded?

🚀 Key Features

📝 Text Editor (30+ Tools)

📊 Advanced Analysis Dashboard

🔍 Text Comparison

🛠️ Utility Tools

💾 Save & Export Options

🎨 Themes & Customization

⌨️ Keyboard Shortcuts

🛠️ Built With

📦 Installation & Setup

📦 Installation & Setup

Prerequisites

Step-by-Step Installation

🔧 Troubleshooting

🚀 Available Scripts

npm start

npm test

npm run build

npm run eject

📱 How to Use

🔤 Text Editor

🔍 Text Comparison

🛠️ Utility Tools

🎨 Customization

Changing Themes

Toggle Dark/Light Mode

🎯 Use Cases

� Project Structure

🔒 Privacy & Security

🚀 Deployment

Deploy to GitHub Pages

Deploy to Vercel

Deploy to Netlify

🤝 Contributing

How to Contribute

Contribution Guidelines

🐛 Bug Reports & Feature Requests

📝 Roadmap

📄 License

👨‍💻 Author

🙏 Acknowledgments

💖 Support

📞 Support & Contact

⭐ Star this repo if you find it useful!

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

`npm start`

`npm test`

`npm run build`

`npm run eject`

Packages