teable/CONTRIBUTING.md

Contributing

The base branch is main.

Workflow

Note

Please feature/fix/update... into individual PRs (not one changing everything)

• Create a github fork.
• On your fork, create a branch make the changes, commit and push.
• Create a pull-request.

Checklist

If applicable:

• tests should be included part of your PR (pnpm g:test).
• a changeset should be provided (pnpm g:changeset) to request a version bump.
• documentation should be updated (pnpm g:build-doc to rebuild the api doc).

Local scripts

Name	Description
pnpm g:changeset	Add a changeset to declare a new version
pnpm g:typecheck	Run typechecks in all workspaces
pnpm g:test	Run unit and e2e tests in all workspaces
pnpm g:lint	Display linter issues in all workspaces
pnpm g:lint --fix	Attempt to run linter auto-fix in all workspaces
pnpm g:build	Run build in all workspaces
pnpm g:clean	Clean builds in all workspaces
pnpm clean:global-cache	Clean tooling caches (eslint, jest...)
pnpm deps:check --dep dev	Will print what packages can be upgraded globally (see also .ncurc.yml)
pnpm deps:update --dep dev	Apply possible updates (run pnpm install && pnpm dedupe after)
pnpm check:install	Verify if there's no peer-deps missing in packages
pnpm dedupe	Built-in pnpm deduplication of the lock file

Git message format

This repo adheres to the conventional commit convention.

Commit messages are enforced through commitlint and a husky commit-msg hook.

Activated prefixes

• chore: Changes that affect the build system or external dependencies
• ci: Changes to our CI configuration files and scripts
• docs: Documentation only changes
• feat: A new feature
• fix: A bug fix
• perf: A code change that improves performance
• refactor: A code change that neither fixes a bug nor adds a feature
• lint: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
• test: Adding missing tests or correcting existing tests
• translation: Adding missing translations or correcting existing ones
• revert: When reverting a commit
• style: A change that affects the scss, less, css styles
• release: All related to changeset (pre exit...)

Note

Up-to-date configuration can be found in commitlint.config.js.

Structure

.
├── apps
│   ├── ...
│   └── nextjs-app
├── packages
│   ├── ...
│   └── core
└ package.json