0.0.4 • Published 1 month ago

rn-development-helper v0.0.4

Weekly downloads
-
License
MIT
Repository
github
Last release
1 month ago

React Native Development-helper

Provides a React component that renders a development-helper.

Platforms Supported

  • iOS
  • Android
  • Web

Getting Started

Installation

npm install -D rn-development-helper
yarn add -D rn-development-helper
bun install -D rn-development-helper
pnpm install -D rn-development-helper

Usage (recommended)

Since the Development-Helper should only be available in Development and Test Environments you should build a shell around it so you can block it from reaching production code.

import React from "react";
import DevelopmentHelper from "rn-development-helper";
import { DevelopmentHelperProps } from "rn-development-helper/src/types";

const UIDevelopmentHelper = (props: DevelopmentHelperProps) => {
  /* 
  * Figure out in which environment you are:
  * This is different for each project.
  * 
  * You should set isVisible based on which environments 
  * you want it to be shown
  */
  const isVisible = true

  if (!isVisible) {
    return null;
  }

  return <DevelopmentHelper {...props} />;
};

export default UIDevelopmentHelper;

Usage (standalone - showing on all Environments)

!!! This should never be available in a Production Environment. !!!

Import the DevelopmentHelper component from rn-development-helper and use it like so:

import React from 'react';
import DevelopmentHelper from "rn-development-helper";

const YourComponent = () => {
  const [someData, setSomeData] = React.useState();
  const [someOtherData, setSomeOtherData] = React.useState();

  return (
    <DevelopmentHelper
      properties={{someData, someOtherData}}
      actions={} />
  );
}

export default YourComponent

Props

Reference

properties

Here you define, which Variables you want to inspect, this can be any Javascript understandable Type (string, number, boolean, object, array, function, etc.).

<DevelopmentHelper 
  properties={{ testVariable, someOtherTestVariable }}
/>

User specified name

<DevelopmentHelper 
  properties={{ 
    test: testVariable, 
    otherTest: someOtherTestVariable 
  }}
/>

actions

Here you define custom actions that you need to access during development or testing.

<DevelopmentHelper 
  actions={{
    test: () => someTestFunction(),
    someOtherTest: () => someOtherTestFunction(),
  }}
/>