We're so excited you're interested in helping with Oku! We are happy to help you get started, even if you don't have any previous open-source experience 😊

1. Take a look at How to Contribute to an Open Source Project on GitHub

1. Check our Github Issues to see if someone has already answered your question.
2. Join our community on Discord and feel free to ask us your questions

• [Min Nodejs 18] & PNPM > 8.7.0 installed
• IDE: VSCode(recommended) or equivalent IDE

Note: If you have nvm, you can run nvm i to install the required version.

• ESLint
• Terminals Manager
• Commands

Note: What is Terminals Maganger and Commands -> #34 (comment)

1. Fork the oku-ui repository
2. Install the project dependencies
   pnpm install
3. Build the project
   pnpm build
4. pnpm story Vue components or utils package, go to packages/vue/src change. Storybook live reload support.

Note: If only working on the core package

pnpm dev label # Run only label component (packages/components) check files name
pnpm dev core utils # Run only core and utils package (packages/core) check files name

pnpm build label # Build only label component (packages/components) check files name
pnpm build core utils # Build only core and utils package (packages/core) check files name

pnpm dev
pnpm build # Build all packages with cache (packages)
pnpm build:skip # Build without cache (packages)

pnpm story # Run Storybook and live reload support (packages/core/src)
pnpm build:storybook # Build Storybook

pnpm lint # Run ESLint
pnpm lint:fix # Run ESLint and fix errors

pnpm test # Run tests
pnpm test:watch # Run tests in watch mode
pnpm test testfilename # Run a specific test file name

pnpm clean: all # Clean all node_modules
pnpm clean:dist # Clean dist folder in all packages
pnpm clean:dts # Clean dts folder in all packages

pnpm oku # Run Oku CLI (packages/cli) // pnpm oku publish (publish packages)

1. We use Vitest for testing
2. To run the tests
   pnpm test
3. Watch mode
   pnpm test:watch
4. To run a specific test file name
   pnpm test testfilename
5. Watch mode for a specific test file name
   pnpm test:watch testfilename

1. To run the linter
   pnpm lint
2. All linting errors will be automatically fixed on commit pnpm lint:fix

1. Before submitting a pull request make sure all tests have passed
2. Reference the relevant issue or pull request and give a clear description of changes/features added when submitting a pull request
3. Make sure the PR title follows conventional commits specification

Oku is made possible by a passionate team and a strong community of developers. If you have any questions or would like to get more involved in the Oku community you can check out:

• Github Issues
• Discord
• Twitter