@gooddata/create-gooddata-react-app

    0.19.1 • Public • Published

    gooddata-create-gooddata-react-app

    (c) 2019-2022 GoodData Corporation This repository is under the BSD-3-clause license available in the LICENSE file and includes additional third party packages under separate open source licenses as specified in the NOTICES file.

    GoodData Create React App

    This is a CLI tool that creates a new React project with a proxy set up to connect to your projects on the GoodData platform. The new app features some widgets and helpers that could come in handy. The app is built on top of Create React App. For more info see Create React App documentation.

    How to use

    To create a project called my-app, run this in your terminal:

    npx @gooddata/create-gooddata-react-app my-app

    Then follow the instructions provided by the CLI.

    When navigating to your application using an IP address instead of localhost, you may run into 401 errors while trying to log in. This is due to proxying and cookie rewriting rules that the generated application uses to get around CORS. Use localhost instead of IP addresses to access the application because the development server rewrites GDC cookies to be for localhost.

    NOTE: We use yarn dependency manager. To install it, follow its documentation. If you don't want to use yarn, provide the --no-install flag like npx @gooddata/create-gooddata-react-app my-app --no-install . This will skip calling yarn install and you will have to manually install the dependencies of the created app. Please note that we do not provide package-lock.json so the application may not work properly when dependencies are installed using npm.

    CLI usage

    @gooddata/create-gooddata-react-app supports several optional flags:

    • --hostname <hostname> URL of your GoodData host
    • -c, --config <config> path to configuration file (see below)
    • --no-install skip yarn installing the app dependencies
    • --verbose output additional logs, useful mainly for debugging and bug reports
    • -h, --help output usage information
    • --backend <backend> switch backend to a desired one (default: bear)
    • --flavor <flavor> desired flavor of the application: js for JavaScript, ts for TypeScript

    Configuration file

    The configuration file has the following structure:

    {
        "hostname": "(Required) URL of the project hosted, e.g., https://developer.na.gooddata.com",
        "appName": "(Optional) name of the app to use",
        "flavor": "(Optional) flavor of the app, e.g., js for JavaScript, ts for TypeScript (default: js)"
    }

    Prerequisites

    Before running @gooddata/create-gooddata-react-app, please make sure that you have all compatible technologies installed on your device.

    Troubleshooting

    In case there are errors while running @gooddata/create-gooddata-react-app, please try these steps.

    Remove older versions

    Sometimes having older versions of @gooddata/create-gooddata-react-app can cause errors. In that case please remove any previously installed versions by running

    npm uninstall -g @gooddata/create-gooddata-react-app
    yarn global remove @gooddata/create-gooddata-react-app

    Force npx to use the latest version

    You can force npx to use latest version of the tool by appending the @latest to the @gooddata/create-gooddata-react-app like

    npx @gooddata/create-gooddata-react-app@latest my-app

    Enable verbose output

    You can increase the logging level of @gooddata/create-gooddata-react-app my-app by providing the --verbose flag like

    npx @gooddata/create-gooddata-react-app my-app --verbose

    Internet Explorer

    Internet Explorer 11 is no longer supported.

    Install

    npm i @gooddata/create-gooddata-react-app

    DownloadsWeekly Downloads

    161

    Version

    0.19.1

    License

    BSD-3-Clause

    Unpacked Size

    3.25 MB

    Total Files

    8

    Last publish

    Collaborators

    • petr.masopust
    • tienbien
    • bich.nguyen
    • khang.nguyen
    • hung.le
    • nghi.lam
    • good-andy
    • ondrej.stumpf
    • thongdo
    • pjiranek
    • manh.nguyen
    • phong.nguyen
    • duc.le
    • martin.milicka
    • damlenpm
    • oleg.morozov
    • hung.cao
    • dominik.cap
    • annguyengd
    • artsiom.yeliseyenka.gooddata
    • hungnguyenauto
    • long.mai
    • rodri360
    • jkittler
    • jaceksan
    • ivan.mjartan
    • lupko
    • nhan.quach
    • tomas.kratochvil
    • jakub-sterba
    • stanislavhacker
    • vojtasii
    • pbenes
    • gooddata-ci
    • nikolacech
    • bugsbunny338
    • bertold8
    • sitina
    • petrjanu
    • tomsatgd
    • xmort
    • ptquang86
    • no23reason
    • afi
    • patrikbraborec
    • brbistas
    • vu.pham
    • matyas.kandl
    • hung.nguyen.hoang
    • tu-ngo
    • trung-le-quoc
    • utdnah
    • de.do
    • tulean
    • nis.hua
    • tuqt1005
    • tu.bui
    • my.duong
    • mai.nguyen
    • hang.ngo
    • scavnickyj
    • thao-luong
    • thuong.nguyen
    • huyen.nguyen
    • vi.phan
    • milan.lempera
    • van.nguyen
    • nestor_encinas
    • an.vuong
    • tmuchka
    • gdjan
    • ngoc-le
    • thuy.tran
    • tmsang
    • jan.jiran
    • martin.plavek
    • ext-zdenek.krejci-gooddata
    • son.nguyen182
    • tuan.tran_gd