Skip to content

Repository files navigation

readablebytrump.com

A satirical web tool that checks if your text contains words that might be too complex for Trump to handle, based on documented "forbidden words" from his administration.

Next.js React TypeScript Tailwind CSS Buy Me A Coffee

🎯 What is readablebytrump.com?

readablebytrump.com is a satirical web application that analyzes text to determine if it contains words that were reportedly "banned" or discouraged during the Trump administration. The tool uses a curated list of words that were allegedly prohibited in government documents and communications.

🚀 Quick Start

Prerequisites

  • Node.js (version 18 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/JeanM38/readablebytrump.com.git
    cd readablebytrump.com
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Run the development server

    npm run dev
    # or
    yarn dev
  4. Open your browser

    Navigate to http://localhost:3000
    

📁 Project Structure

readablebytrump.com/
├── 📄 README.md                    # Project documentation (you are here)
├── 📄 CONTRIBUTING.md              # Contribution guidelines
├── 📄 package.json                 # Project dependencies and scripts
├── 📄 next.config.ts              # Next.js configuration
├── 📄 tsconfig.json               # TypeScript configuration
├── 📄 tailwind.config.js          # Tailwind CSS configuration
├── 📄 eslint.config.mjs           # ESLint configuration
├── 📂 app/                        # Next.js App Router directory
│   ├── 📄 layout.tsx              # Root layout component
│   ├── 📄 page.tsx                # Homepage component
│   └── 📄 globals.css             # Global styles
├── 📂 components/                 # React components
│   └── 📄 TrumpValidator.tsx      # Main validation component
└── 📂 public/                     # Static assets
    └── 📄 banned_words.json       # Database of "forbidden words"

🛠️ Available Scripts

Command Description
npm run dev Start development server with Turbopack
npm run build Build the application for production
npm run start Start production server
npm run lint Run ESLint for code quality

📊 How It Works

  1. Data Loading: The app fetches the banned words list from public/banned_words.json
  2. Text Analysis: User input is analyzed against the loaded word list
  3. Validation Logic: If the text contains any "complex" words, it's marked as "not Trump-readable"
  4. Results Display: The UI shows whether Trump could theoretically read the text

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for detailed guidelines.

Quick Contributing Guide:

  1. Code contributions: Fork → Feature branch → Pull request
  2. Bug reports: Use GitHub issues with detailed information
  3. Word list updates: Must include verified sources and documentation

Important: All additions to banned_words.json must be properly sourced with reliable references.

📝 License MIT

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

⚠️ Disclaimer

This is a satirical project intended for educational and entertainment purposes. The "banned words" list is based on publicly reported information about word restrictions during the Trump administration. This tool does not represent actual reading capabilities of any individual.

🔗 Links


Made with ❤️ and a sense of humor about politics.

About

A minimalistic Next.js app that checks whether your text is “Trump-readable” — meaning it doesn’t contain any of the forbidden words identified during the Trump administration era.

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages