Skip to content

Commit

Permalink
Update contributing.md
Browse files Browse the repository at this point in the history
  • Loading branch information
mayank1513 committed May 6, 2024
1 parent cca3dbe commit 14ba30e
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 31 deletions.
4 changes: 4 additions & 0 deletions TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,7 @@
- [ ] Feel free to star this template, contribute, and/or sponsor the [`terbo-repo-template`](https://github.com/react18-tools/turbo-repo-template) project or my [other open-source work](https://github.com/sponsors/mayank1513)
- [ ] You can also fork the [`terbo-repo-template`](https://github.com/react18-tools/turbo-repo-template/fork) and add your package to `scripts/featured.json`
- If approved, your package will be automatically added to FEATURED.md and also published on the home page of this repo.

<hr />

<p align="center" style="text-align:center">with 💖 by <a href="https://mayank-chaudhari.vercel.app" target="_blank">Mayank Kumar Chaudhari</a></p>
66 changes: 35 additions & 31 deletions contributing.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,69 @@
# Contributing to React18 Loaders
# Contribution Guidelines

## What's inside?
## Overview

### Utilities
### Included Utilities

This Turborepo template includes pre-configured tools:
This template is equipped with pre-configured tools to streamline your development process:

- Monorepo setup powered by TurboRepo
- TurboRepo is renowned for its efficient builds and caching mechanisms, minimizing unnecessary builds.
- [TypeScript](https://www.typescriptlang.org/) for static type checking
- [ESLint](https://eslint.org/) for code linting
- [Prettier](https://prettier.io) for code formatting
- Plop-based code generator for scaffolding new components
- Automatic rebranding of this template to match your repo name
- Plop-based code generator for effortlessly scaffolding new components
- Automatic rebranding functionality for this template
- Workflows facilitating testing, documentation, dependency updates, and deployment of your docs and packages
- Build setup capable of creating appropriate CJS and ESM builds to support React 18 server and client component exports from the same library
- Out-of-the-box support for SCSS modules for `lib` and `packages/shared`

### Apps and Packages

This Turborepo includes the following packages/examples:
This TurboRepo comprises the following packages/examples, all written in [TypeScript](https://www.typescriptlang.org/):

- `nextjs`: a [Next.js](https://nextjs.org/) app
- `vite`: a [Vite.js](https://vitest.dev) app
- `eslint-config-custom`: `eslint` configurations (includes `eslint-config-next` and `eslint-config-prettier`)
- `tsconfig`: `tsconfig.json`s used throughout the monorepo
- `@example/nextjs`: a [Next.js](https://nextjs.org/) app
- `@example/vite`: a [Vite.js](https://vitest.dev) app
- `@example/remix`: a Remix app
- `@repo/eslint-config`: `eslint` configurations (includes `eslint-config-next` and `eslint-config-prettier`)
- `@repo/typescript-config`: `tsconfig.json`s used throughout the monorepo
- `@repo/jest-presets`: Jest presets for unit testing
- `@repo/logger`: A configurable shared logger utility
- `@repo/shared`: An internal library of components utilized by the examples
- `react18-loaders`: a React component library (The core package published to NPM)

- `react18-loaders`: a React component library lives in `./lib`
## Automated File Generation

Each package/example is 100% [TypeScript](https://www.typescriptlang.org/).

## Automatic file generation

- Just run `yarn turbo gen` and follow the prompts to auto-generate your new component with a test file and dependency linking, adhering to best practices automatically.
Simply execute `yarn turbo gen` and follow the prompts to automatically generate your new component along with a test file and dependency linking, adhering to best practices.

### Build

To build all apps and packages, run the following command:
To build all apps and packages, execute the following command:

```bash
cd my-turborepo
pnpm build
```

### Develop
### Development

To develop all apps and packages, run the following command:
For development of all apps and packages, run:

```bash
cd my-turborepo
pnpm dev
```

### Run unit tests
### Running Unit Tests

To run unit tests, run the following command:
To execute unit tests, use:

```bash
cd my-turborepo
pnpm test
```

### Linting and formatting
### Linting and Formatting

Before creating a PR, make sure lint is passing and also run the formatter to properly format the code.
Before creating a PR, ensure that linting passes and format the code properly with:

```bash
cd my-turborepo
pnpm lint
```

Expand All @@ -71,9 +73,9 @@ and
pnpm format
```

## Useful Links
## Useful Resources

Learn more about Turborepo and Next.js:
Explore more about TurboRepo and Next.js through the following links:

- [React and Next.js with TypeScript](https://www.udemy.com/course/react-and-next-js-with-typescript/?referralCode=7202184A1E57C3DCA8B2) - an interactive Next.js course.
- [The Game of Chess with Next.js, React, and TypeScript](https://www.udemy.com/course/game-of-chess-with-nextjs-react-and-typescrypt/?referralCode=851A28F10B254A8523FE)
Expand All @@ -84,7 +86,9 @@ Learn more about Turborepo and Next.js:
- [Configuration Options](https://turbo.build/repo/docs/reference/configuration)
- [CLI Usage](https://turbo.build/repo/docs/reference/command-line-reference)

> A quick tip: Delete all stale branches `git branch --merged main | grep -v '^[ *]*main$' | xargs git branch -d`
> Quick tip: Remove all stale branches with `git branch --merged main | grep -v '^[ *]*main$' | xargs git branch -d`
> <img src="https://user-images.githubusercontent.com/74038190/213844263-a8897a51-32f4-4b3b-b5c2-e1528b89f6f3.png" style="height: 20px"/> Consider enrolling in [our courses](https://mayank-chaudhari.vercel.app/courses) or [sponsoring](https://github.com/sponsors/mayank1513) our work.
<hr />

Expand Down

0 comments on commit 14ba30e

Please sign in to comment.