mirror of https://github.com/gradio-app/gradio.git synced 2024-11-27 01:40:20 +08:00

History

Abubakar Abid 4d58ae79b3 Improvements to `State` (#2100 ) * state * state fix * variable -> state * fix * added state tests * formatting * fix test * formatting * fix test * added tests for bakcward compatibility * formatting * config fix * additional doc * doc fix * formatting		2022-08-29 09:53:05 -07:00
..
packages	Improvements to `State` (#2100 )	2022-08-29 09:53:05 -07:00
.editorconfig
.gitignore	add test infra + add browser tests to CI (#852 )	2022-03-23 15:19:12 +00:00
.npmrc	fix pnpm filters for 7.x (#1927 )	2022-08-02 12:02:06 -07:00
.prettierignore	Form layout (#1054 )	2022-04-22 10:19:59 +01:00
.prettierrc.json
globals.d.ts	Fix the types (#1843 )	2022-07-21 19:12:46 +01:00
JSX.d.ts	Fix the types (#1843 )	2022-07-21 19:12:46 +01:00
package-lock.json	changes	2022-03-02 22:59:36 +00:00
package.json	Fixes: Model3D component loads forever when used as input and cache_examples=False (#1939 )	2022-08-03 17:03:01 -04:00
playwright-setup.js	Fix the types (#1843 )	2022-07-21 19:12:46 +01:00
playwright.config.js	add test infra + add browser tests to CI (#852 )	2022-03-23 15:19:12 +00:00
pnpm-lock.yaml	Cleaning up the way data is processed for components (#1967 )	2022-08-23 08:31:04 -07:00
pnpm-workspace.yaml	undo pretty format of website	2022-02-14 16:50:15 -05:00
postcss.config.cjs	fix tooling issues	2022-02-25 12:24:32 +00:00
README.md	Update text (#1050 )	2022-04-21 10:07:43 +01:00
svelte.config.js	fix tooling issues	2022-02-25 12:24:32 +00:00
tailwind.config.cjs	distribute gradio as a web component (#1444 )	2022-06-07 11:11:44 -07:00
tsconfig.json	Fix the types (#1843 )	2022-07-21 19:12:46 +01:00
vitest.config.ts	add unit tests (#602 )	2022-02-14 15:24:04 +00:00

README.md

gradio-ui

This folder contains all of the Gradio UI and component source code.

set up
running the application
local development
building for production
quality checks
ci checks

Note: The below assumes you are in the ui directory unless alternative instructions are given.

setup

This folder is managed as 'monorepo' a multi-package repository which make dependency management very simple. In order to do this we use pnpm as our package manager.

Make sure pnpm is installed by following the installation instructions for your system.

You will also need node which you probably already have

running the application

Install all dependencies from the ui folder:

pnpm i

This will install the dependencies for all packages within the ui folder and link any local packages

local development

To develop locally, open two terminal tabs from the root of the repository.

Run the python test server, from the root directory:

cd demo/kitchen_sink
python run.py

This will start a development server on port 7860 that the web app is expecting.

Run the web app:

cd ui #move back into ui if you haven't already
pnpm dev

building for production

From the ui folder run the build.

pnpm build

This will create the necessary files in ui/app/public and also in gradio/templates/frontend.

quality checks

The repos currently has two quality checks that can be run locally and are run in CI.

formatting

Formatting is handled by prettier to ensure consistent formatting and prevent style-focused conversations. Formatting failures will fails CI and should be reoslve before merging.

To check formatting:

pnpm format:check

If you have formatting failures then you can run the following command to fix them:

pnpm format:write

type checking

We use TypeScript to provide static types to javascript code. These checks are also run in CI.

to typecheck the code:

pnpm ts:check

ci checks

Currently the following checks are run in CI:

Format check (pnpm format:check)
Type check (pnpm ts:check)
Build as a smoke test (pnpm build)