Skip to content

Commit b439139

Browse files
authored
docs(README): Adds in info about projects in the repo (#8)
1 parent fd6bd00 commit b439139

File tree

5 files changed

+344
-296
lines changed

5 files changed

+344
-296
lines changed

.changeset/doc-changset.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
"@jhecht/eslint-plugin": patch
3+
"@jhecht/arktype-utils": patch
4+
"@jhecht/design-tokens": patch
5+
"@jhecht/typescript-config": patch
6+
"@jhecht/vite-plugin-design-tokens": patch
7+
---
8+
9+
please hold

.github/workflows/pr.yml

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,31 @@ on:
33
pull_request:
44

55
jobs:
6+
changesets:
7+
name: Changeset Present?
8+
runs-on: ubuntu-latest
9+
steps:
10+
- uses: actions/checkout@v4
11+
with:
12+
fetch-depth: 0
13+
- run: git fetch origin main:main
14+
- uses: pnpm/action-setup@v2
15+
name: Install PNPM
16+
with:
17+
versions: 8
18+
- uses: actions/cache@v3
19+
name: setup PNPM cache
20+
with:
21+
path: ${{ env.STORE_PATH }}
22+
key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
23+
restore-keys: |
24+
${{ runner.os}}-pnpm-store
25+
- uses: actions/setup-node@v3
26+
with:
27+
node-version: '18.x'
28+
- run: pnpm i --frozen-lockfile
29+
- run: pnpm changeset:ci
30+
631
test:
732
name: Test changed
833
runs-on: ubuntu-latest

README.md

Lines changed: 21 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,81 +1,35 @@
1-
# Turborepo starter
1+
# Jhecht's Utility Mono Repo
22

3-
This is an official starter Turborepo.
3+
This is a repo that holds all of my random projects.
44

5-
## Using this example
5+
## Projects
66

7-
Run the following command:
7+
Currently there are 5 projects in the repo:
88

9-
```sh
10-
npx create-turbo@latest
11-
```
9+
1. [ArkType Utils](#arktype-utils)
10+
2. [Design Tokens](#design-tokens)
11+
3. [Eslint Plugin](#eslint-plugin)
12+
4. [Typescript Config](#typescript-config)
13+
5. [Vite Plugin Design Tokens](#vite-plugin-design-tokens)
1214

13-
## What's inside?
15+
## ArkType Utils
1416

15-
This Turborepo includes the following packages/apps:
17+
[ArkType](https://arktpe.io) is a 1:1 TypeScript validation library. I utilize it heavily, so I created some wrapper utils around it
1618

17-
### Apps and Packages
19+
## Design Tokens
1820

19-
- `docs`: a [Next.js](https://nextjs.org/) app
20-
- `web`: another [Next.js](https://nextjs.org/) app
21-
- `@repo/ui`: a stub React component library shared by both `web` and `docs` applications
22-
- `@repo/eslint-config`: `eslint` configurations (includes `eslint-config-next` and `eslint-config-prettier`)
23-
- `@repo/typescript-config`: `tsconfig.json`s used throughout the monorepo
21+
This is a port over of [jhechtf/design-tokens](https://github.com/jhechtf/design-tokens). The original project was written for
22+
Deno, but with Deno basically becoming a sandbox for Node, I've decided to move the library over to Node fully, allowing for the
23+
[Vite Plugin](#vite-plugin-design-tokens)
2424

25-
Each package/app is 100% [TypeScript](https://www.typescriptlang.org/).
25+
## Eslint Plugin
2626

27-
### Utilities
27+
Common ESLint stuff I use.
2828

29-
This Turborepo has some additional tools already setup for you:
29+
## TypeScript Config
3030

31-
- [TypeScript](https://www.typescriptlang.org/) for static type checking
32-
- [ESLint](https://eslint.org/) for code linting
33-
- [Prettier](https://prettier.io) for code formatting
31+
Common TypeScript Config I use for most projects
3432

35-
### Build
33+
## Vite Plugin Design Tokens
3634

37-
To build all apps and packages, run the following command:
38-
39-
```
40-
cd my-turborepo
41-
pnpm build
42-
```
43-
44-
### Develop
45-
46-
To develop all apps and packages, run the following command:
47-
48-
```
49-
cd my-turborepo
50-
pnpm dev
51-
```
52-
53-
### Remote Caching
54-
55-
Turborepo can use a technique known as [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching) to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.
56-
57-
By default, Turborepo will cache locally. To enable Remote Caching you will need an account with Vercel. If you don't have an account you can [create one](https://vercel.com/signup), then enter the following commands:
58-
59-
```
60-
cd my-turborepo
61-
npx turbo login
62-
```
63-
64-
This will authenticate the Turborepo CLI with your [Vercel account](https://vercel.com/docs/concepts/personal-accounts/overview).
65-
66-
Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your Turborepo:
67-
68-
```
69-
npx turbo link
70-
```
71-
72-
## Useful Links
73-
74-
Learn more about the power of Turborepo:
75-
76-
- [Tasks](https://turbo.build/repo/docs/core-concepts/monorepos/running-tasks)
77-
- [Caching](https://turbo.build/repo/docs/core-concepts/caching)
78-
- [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching)
79-
- [Filtering](https://turbo.build/repo/docs/core-concepts/monorepos/filtering)
80-
- [Configuration Options](https://turbo.build/repo/docs/reference/configuration)
81-
- [CLI Usage](https://turbo.build/repo/docs/reference/command-line-reference)
35+
WIP - added in eagerly.

package.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,16 @@
55
"build": "turbo build",
66
"dev": "turbo dev",
77
"lint": "turbo lint",
8+
"lint:fix": "turbo lint:fix",
89
"prettier:format": "prettier --write \"**/*.{ts,tsx,md}\"",
910
"prettier:check": "prettier --check \"**/*.{ts,tsx,md}\"",
1011
"publish-packages": "turbo run build lint test && changeset version && changeset publish",
1112
"test": "turbo run test",
12-
"test:changed": "turbo run --filter=[main...HEAD] test:ci"
13+
"test:changed": "turbo run --filter=[main...HEAD] test:ci",
14+
"changeset:ci": "changeset status"
1315
},
1416
"devDependencies": {
17+
"@changesets/cli": "^2.27.1",
1518
"@jhecht/eslint-plugin": "workspace:*",
1619
"@jhecht/typescript-config": "workspace:*",
1720
"prettier": "^3.1.1",
@@ -20,8 +23,5 @@
2023
"packageManager": "pnpm@8.9.0",
2124
"engines": {
2225
"node": ">=18"
23-
},
24-
"dependencies": {
25-
"@changesets/cli": "^2.27.1"
2626
}
2727
}

0 commit comments

Comments
 (0)