https://github.com/savaughn/MetroBundlerLauncher

A metro bundler launcher for react native development written in C with GTK4
https://github.com/savaughn/MetroBundlerLauncher

c gtk4 metro-bundler react-native

Last synced: 3 months ago
JSON representation

A metro bundler launcher for react native development written in C with GTK4

• Host: GitHub
• URL: https://github.com/savaughn/MetroBundlerLauncher
• Owner: savaughn
• Created: 2024-10-11T01:28:24.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2024-11-13T03:01:56.000Z (7 months ago)
• Last Synced: 2025-02-09T00:49:30.508Z (4 months ago)
• Topics: c, gtk4, metro-bundler, react-native
• Language: C
• Homepage:
• Size: 2.16 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        


    



[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ncorgan/metro_launcher/blob/master/LICENSE.txt) [![GitHub release (latest by date)](https://img.shields.io/github/v/release/savaughn/metro_launcher)](https://github.com/savaughn/metro_launcher/releases) [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/savaughn/metro_launcher/macos.yml?branch=master)](https://github.com/savaughn/metro_launcher/actions) [![GitHub issues](https://img.shields.io/github/issues/savaughn/metro_launcher)](https://github.com/savaughn/metro_launcher/issues) [![GitHub all releases](https://img.shields.io/github/downloads/savaughn/metro_launcher/total)](https://github.com/savaughn/metro_launcher/releases)

Metro Bundler Launcher is a GTK4-based application designed to manage the Metro Bundler for React Native projects.









## Using Metro Bundler Launcher

This requires the minimum React Native development environment to be set up. 

### Installation

#### install homebrew 

  ```sh

  bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  ```

#### install node

    brew install node

#### download and install latest release of metro_launcher

Get the latest release from [release page](github.com/savaughn/metro_launcher/releases). Open the installer dmg and move the app to Applications folder. Right click and open the app on first launch to bypass security settings.

### Usage

- `working directory`: Input a project directory path in the text field labeled "project root".

- `Enviromental Variables`: Input any environment variables in the text field labeled "env vars" such as "ENV=development". These will be appended to the metro command.

- `Port`: Input a port number in the text field labeled "port". This will be used to start the metro bundler on the specified port.

- `Debugger`: Enable the hermes debugger by checking the checkbox labeled "Enable Hermes Debugger".

- `Status Light`: The status light will change color based on the status of the metro bundler. Green indicates the metro bundler is running, red indicates the metro bundler is not running on the specified port.

- `Buttons`:

    - `Play`: Start the metro bundler.

    - `Stop`: Stop the metro bundler.

    - `Restart`: Restart the metro bundler.

    - `Dark Mode`: (lightbulb) Toggle dark mode.

### Options

Options are stored in the `~/Library/Application Support/MetroBundlerLauncher` directory.

## Contributing

### Prerequisites

- GTK4

- GCC

- macOS (for setup script)

### Setup for MacOS

1. **Clone the repository**:

    ```sh

    git clone https://github.com/savaughn/metro_launcher.git 

    cd metro_launcher

    ```

2. **Install dependencies**:

    ```sh

    ./setup_macos.sh

    ```

3. **Build the project**:

    ```sh

    make

    ```

4. **Run the application**:

    ```sh

    make run

    ```

### Makefile

The `Makefile` includes targets for building and running the project:

- `make`: Builds the project.

- `make run`: Runs the built executable.

- `make clean`: Cleans up the build artifacts.

## Contributing

 - Fork and PR, please.

## License

This project is licensed under the MIT License.