Nuru Monorepo

🌍 Mission

Our goal is to make Nuru accessible to everyone, everywhere. By compiling the core Nuru interpreter to WebAssembly (Wasm), we enable:

• Interactive Learning: Run Nuru code directly in your browser.
• Zero-Install Setup: No need to install Go or command-line tools to get started.
• Cross-Platform Compatibility: Use Nuru on any device with a modern web browser.

🏗️ Project Structure

This repository is optimized as a monorepo.

Read here for more information.

Packages (/packages)

• @nuru/wasm: The heart of the project. A Go-based WebAssembly interpreter that bridges Nuru's backend logic with the browser's JavaScript environment.

Apps (/apps)

• nuru-svelte: The primary Nuru Playground. A fast, reactive web application built with Svelte that lets users write, run, and learn Nuru code interactively.
• nuru-playground: An alternative playground implementation using Next.js.

🚀 Getting Started

Follow these steps to set up the development environment.

Prerequisites

• Node.js (^18.13)
• pnpm (Package Manager)
• Go (^1.19.0) - Required for building the WASM binary

Installation

1. Clone the repository:

   git clone https://github.com/teKsafari/nuru-mono.git
   cd nuru-mono

2. Install dependencies:

   pnpm install

⚡ Development

We use turbo to manage tasks across the monorepo.

• Start Development Server (Runs all apps):

  turbo run dev

• Build All Packages & Apps:

  turbo run build

• Run Tests:

  turbo run test

Tip: You can filter tasks to specific packages, e.g., turbo run dev --filter=nuru-svelte.

🤝 Contributing

We welcome contributions! Whether you're fixing bugs in the WASM bridge, enhancing the playground UI, or improving documentation, your help is appreciated.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

---

Powered by NuruProgramming.