OKavangoIDE

The official Zumbra IDE

⚙️ ZUMBRA is a simple, fun, and expressive programming language made for learning, experimenting, and enjoying the beauty of code. OKavangoIDE or, for close friends, OKIDE was created to help you enjoy coding with Zumbra, featuring syntax highlighting, file management, and a smooth development experience.

🚀 Features

• 🎨 Real-time syntax highlighting for Zumbra
• 📂 File explorer with in-editor editing
• 💾 Save and manage your Zumbra scripts easily
• 🧠 Simple, minimal UI for distraction-free coding
• ☕ Powered by Java

💡 Tip:

Press Ctrl + S to quickly save your file, or right-click a folder to create a new Zumbra file!

🎨 The current interface:

🚀 How to run?

🐧 Running on Linux

You can run OKavangoIDE on most Linux distributions. These instructions were tested on Arch Linux, but the process is similar for others such as Ubuntu, Debian, or Fedora.

📦 Requirements

• Java Development Kit (JDK) 17 or later
• Apache Maven

🛠️ Installation Steps

1. Install dependencies
   On Arch Linux:
   sudo pacman -Syu jdk-openjdk maven
   On Ubuntu/Debian:
   sudo apt update && sudo apt install openjdk-17-jdk maven
2. Clone the repository
   git clone https://github.com/JoseLucasapp/OkavangoIDE.git
cd OkavangoIDE
3. Ensure you're using a JDK (not a JRE)
   java -version
javac -version
   On Arch, if needed:
   sudo archlinux-java set java-21-openjdk
4. Build the project
   mvn clean install
5. Run the application
   mvn exec:java -Dexec.mainClass="com.joselucasapp.okavangoide.Main"

🪟 Running on Windows

OKavangoIDE also runs smoothly on Windows. Just follow the steps below to get everything set up.

📦 Requirements

• Java Development Kit (JDK) 17 or later (JDK 21 recommended)
• Apache Maven
• Git

🛠️ Installation Steps

1. Install the JDK
   Download the JDK from Oracle or use a distribution like OpenJDK via https://adoptium.net/.
   After installation, set the JAVA_HOME environment variable and add the JDK bin folder to your system Path.
2. Install Apache Maven
   Download it from https://maven.apache.org/download.cgi
   Extract the files and add the Maven bin folder to your Path environment variable.
3. Verify Java and Maven are working
   Open Command Prompt or PowerShell and run:
   java -version
mvn -v
4. Clone the repository
   git clone https://github.com/JoseLucasapp/OkavangoIDE.git
cd OkavangoIDE
5. Build the project
   mvn clean install
6. Run the application
   mvn exec:java -Dexec.mainClass="com.joselucasapp.okavangoide.Main"

Tip: You can use Windows Terminal or Git Bash for a better CLI experience with Git and Maven.

🤝 Contributing

We welcome contributions! Please read our Contributing Guide and Code of Conduct before submitting pull requests.

Built with ❤️ • project in progress 🚧