💅 Javuh - Java with Brainrot

Java, but make it ✨bussin'✨

Write code like you're terminally online. Compile it like a professional.

🚀 Quick Start • 📚 Documentation • 💅 Examples • 🤝 Contributing • 📖 Reference

---

🔥 What is Javuh?

Javuh is the brainrot programming language for Java. Javuh brings Gen-Z slang to Java development with 100+ keywords, professional tooling, and full language support.

squad_up HelloWorld start_yappin
    let_him_cook(String[] args) start_yappin
        yap("Hello, World! 💅") periodt
    stop_yappin
stop_yappin periodt

Compiles with javac. Runs like any Java program.

✨ Why Javuh?

• 100+ keywords covering all Java features
• 🛠️ Professional tooling - CLI, VS Code extension, watch mode, templates
• 🎓 Educational - Learn Java through memorable slang syntax
• 🔥 Actually works - Not a toy, a production-ready transpiler
• 💅 Maximum vibes - Programming should be fun

---

🚀 Quick Start

Installation (2 minutes)

Prerequisites:

• Python 3.7+
• Java JDK 8+
• VS Code (optional, but recommended for the 💅 icon!)

One-command install:

git clone https://github.com/SaaiAravindhRaja/Javuh.git
cd Javuh && ./install.sh

That's it! The installer:

• ✅ Verifies Python & Java
• ✅ Makes CLI executable
• ✅ Adds javuh to your PATH
• ✅ Configures your shell (zsh/bash/fish)

Manual install: See docs/QUICKSTART.md

---

💻 Your First Javuh Program

1️⃣ Create a new project

javuh init my-first-app
cd my-first-app

2️⃣ Write some code (src/Main.javuh)

squad_up Calculator start_yappin
    let_him_cook(String[] args) start_yappin
        rizz_num num1 be 10 periodt
        rizz_num num2 be 20 periodt
        
        yap("Sum is: " + (num1 + num2)) periodt
        yap("No cap, math is bussin'! 💅") periodt
    stop_yappin
stop_yappin periodt

3️⃣ Run it

javuh run src/Main.javuh

Output:

🔮 Transpiling Javuh to Java...
✅ Transpiled to build/Main.java
🔨 Compiling Java...
✅ Compilation successful!
🚀 Running Calculator...
──────────────────────────────────────────────────
Sum is: 30
No cap, math is bussin'! 💅
──────────────────────────────────────────────────
✨ Program completed successfully! No cap!

---

🎯 Features

🎯 Features

• 🔧 Powerful CLI - run, build, watch, init, version commands
• 💅 VS Code Extension - Custom 💅 file icon, syntax highlighting, snippets
• 📦 Project Templates - Hello World, Console App, OOP starter projects
• 👀 Watch Mode - Auto-transpile on file save
• 📚 Comprehensive Docs - 34+ files covering everything

---

💅 Examples

💅 VS Code Integration

• Custom file icon - 💅 emoji displays next to .javuh files
• Syntax highlighting - Full TextMate grammar support
• Code snippets - 10+ templates (squad, method, loop, etc.)
• Auto-complete - IntelliSense for Javuh keywords
• Right-click menu - "Run in Javuh" option

Install extension:

cd .vscode-extension && ./install.sh
# Then reload VS Code

📦 Project Templates

javuh init my-app hello-world   # Simple Hello World
javuh init my-app console-app   # Interactive console app
javuh init my-app oop-project   # Object-oriented template

👀 Watch Mode (Dev Workflow)

javuh watch src/
# Now edit your .javuh files - they auto-transpile on save!

---

📖 The Slangtionary

104+ keywords covering all Java features. Here's a taste:

Category	Javuh	Java
Classes	squad_up	public class
Main Method	let_him_cook(String[] args)	public static void main(String[] args)
Print	yap("Hello!")	System.out.println("Hello!")
Variables	rizz_num age be 25	int age = 25
	words name be "Chad"	String name = "Chad"
Conditionals	is_it_giving	if
	nah_id_win	else
Loops	keep_vibing	for
	do_it_again	while
Booleans	no_cap / cap	true / false
Exceptions	f_around / find_out	try / catch
OOP	copy_the_assignment	extends
	fake_it_till_you_make_it	implements
Returns	its_giving_back	return
Operators	be	=
	less_than / greater_than	< / >
	equals_check	==
Structure	start_yappin / stop_yappin	{ / }
	periodt	;

📖 See QUICK_REFERENCE.md for all 104+ keywords

---

🤝 Contributing

We love contributions! Here's how to get involved:

Ways to Contribute

• 🐛 Report bugs - Use our bug report template
• ✨ Suggest features - Use our feature request template
• 📚 Improve docs - Fix typos, add examples, clarify explanations
• 💻 Write code - Add keywords, fix bugs, implement features
• 🎨 Create content - Tutorials, videos, blog posts

Getting Started

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Test thoroughly (javuh run src/*.javuh)
5. Commit (git commit -m 'feat: add amazing feature')
6. Push (git push origin feature/amazing-feature)
7. Open a Pull Request

Read CONTRIBUTING.md for detailed guidelines

---

📱 Community

• 📖 FAQ • � Issues • � Discussions
• ⭐ Star this repo • 🍴 Fork and contribute • 📣 Share with #Javuh
• 📧 Email: [email protected]

---

🗺️ Roadmap

✅ v1.0.0 - Transpiler, CLI, VS Code extension, 104+ keywords, docs, templates
🔜 v1.1.0 - REPL mode, online playground, linter, package managers
🔮 v2.0+ - IntelliJ plugin, language server, debugger integration

See CHANGELOG.md

---

📜 License

MIT License - Do whatever you want with this. It's a meme language that actually works. No cap.

See LICENSE for details.

---

🙏 Acknowledgments

Inspired by PyGyat

Built with Python, Java, VS Code, and maximum vibes 💅

---

Report Bug • Request Feature • Documentation • Contributing