Skip to content

Commit 69bdd25

Browse files
kentcdoddskentcdodds
committed
init
0 parents  commit 69bdd25

32 files changed

+13291
-0
lines changed

‎.github/workflows/validate.yml

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
name: deploy
2+
3+
concurrency:
4+
group: ${{ github.workflow }}-${{ github.ref }}
5+
cancel-in-progress: true
6+
7+
on:
8+
push:
9+
branches:
10+
- 'main'
11+
pull_request:
12+
branches:
13+
- 'main'
14+
jobs:
15+
setup:
16+
strategy:
17+
matrix:
18+
os: [ubuntu-latest, windows-latest, macos-latest]
19+
runs-on: ${{ matrix.os }}
20+
steps:
21+
- name: ⬇️ Checkout repo
22+
uses: actions/checkout@v4
23+
24+
- name: ⎔ Setup node
25+
uses: actions/setup-node@v4
26+
with:
27+
node-version: 20
28+
29+
- name: ▶️ Run setup script
30+
run: npm run setup
31+
32+
- name: ʦ TypeScript
33+
run: npm run typecheck
34+
35+
- name: ⬣ ESLint
36+
run: npm run lint
37+
38+
deploy:
39+
name: 🚀 Deploy
40+
runs-on: ubuntu-latest
41+
# only deploy main branch on pushes on non-forks
42+
if:
43+
${{ github.ref == 'refs/heads/main' && github.event_name == 'push' &&
44+
github.repository_owner == 'epicweb-dev' }}
45+
46+
steps:
47+
- name: ⬇️ Checkout repo
48+
uses: actions/checkout@v4
49+
50+
- name: 🎈 Setup Fly
51+
uses: superfly/flyctl-actions/[email protected]
52+
53+
- name: 🚀 Deploy
54+
run: flyctl deploy --remote-only
55+
working-directory: ./epicshop
56+
env:
57+
FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}

‎.gitignore

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
node_modules
2+
3+
workspace/
4+
**/.cache/
5+
**/build/
6+
**/public/build
7+
**/playwright-report
8+
data.db
9+
/playground
10+
**/tsconfig.tsbuildinfo
11+
12+
# in a real app you'd want to not commit the .env
13+
# file as well, but since this is for a workshop
14+
# we're going to keep them around.
15+
# .env

‎.npmrc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
legacy-peer-deps=true
2+
registry=https://registry.npmjs.org/

‎LICENSE.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
This material is available for private, non-commercial use under the
2+
[GPL version 3](http://www.gnu.org/licenses/gpl-3.0-standalone.html). If you
3+
would like to use this material to conduct your own workshop, please contact us
4+
at [email protected]

‎README.md

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
<div>
2+
<h1 align="center"><a href="https://www.epicweb.dev/workshops">Build React Hooks 🪝</a></h1>
3+
<strong>
4+
Understand how React hooks work by building them from scratch
5+
</strong>
6+
<p>
7+
React hooks are a core building block upon which we build our React apps. Understanding them at a fundamental level will help you use them more efficiently. You'll go from "it doesn't work and I don't know why" to "it works and I understand why."
8+
</p>
9+
</div>
10+
11+
<hr />
12+
13+
<div align="center">
14+
<a
15+
alt="Epic Web logo with the words Deployed Version"
16+
href="https://epicweb-dev-build-react-hooks.fly.dev/"
17+
>
18+
<img
19+
width="300px"
20+
src="https://github-production-user-asset-6210df.s3.amazonaws.com/1500684/254000390-447a3559-e7b9-4918-947a-1b326d239771.png"
21+
/>
22+
</a>
23+
</div>
24+
25+
<hr />
26+
27+
<!-- prettier-ignore-start -->
28+
[![Build Status][build-badge]][build]
29+
[![GPL 3.0 License][license-badge]][license]
30+
[![Code of Conduct][coc-badge]][coc]
31+
<!-- prettier-ignore-end -->
32+
33+
## Prerequisites
34+
35+
- TODO: add prerequisites
36+
- Some
37+
- Pre-requisite
38+
- links
39+
- here
40+
41+
## Pre-workshop Resources
42+
43+
Here are some resources you can read before taking the workshop to get you up to
44+
speed on some of the tools and concepts we'll be covering:
45+
46+
- TODO: add resources
47+
48+
## System Requirements
49+
50+
- [git][git] v2.18 or greater
51+
- [NodeJS][node] v18 or greater
52+
- [npm][npm] v8 or greater
53+
54+
All of these must be available in your `PATH`. To verify things are set up
55+
properly, you can run this:
56+
57+
```shell
58+
git --version
59+
node --version
60+
npm --version
61+
```
62+
63+
If you have trouble with any of these, learn more about the PATH environment
64+
variable and how to fix it here for [windows][win-path] or
65+
[mac/linux][mac-path].
66+
67+
## Setup
68+
69+
This is a pretty large project (it's actually many apps in one) so it can take
70+
several minutes to get everything set up the first time. Please have a strong
71+
network connection before running the setup and grab a snack.
72+
73+
> **Warning**: This repo is _very_ large. Make sure you have a good internet
74+
> connection before you start the setup process. The instructions below use
75+
> `--depth` to limit the amount you download, but if you have a slow connection,
76+
> or you pay for bandwidth, you may want to find a place with a better
77+
> connection.
78+
79+
Follow these steps to get this set up:
80+
81+
```sh nonumber
82+
git clone --depth 1 https://github.com/epicweb-dev/build-react-hooks.git
83+
cd build-react-hooks
84+
npm run setup
85+
```
86+
87+
If you experience errors here, please open [an issue][issue] with as many
88+
details as you can offer.
89+
90+
## The Workshop App
91+
92+
Learn all about the workshop app on the
93+
[Epic Web Getting Started Guide](https://www.epicweb.dev/get-started).
94+
95+
[![Kent with the workshop app in the background](https://github-production-user-asset-6210df.s3.amazonaws.com/1500684/280407082-0e012138-e01d-45d5-abf2-86ffe5d03c69.png)](https://www.epicweb.dev/get-started)
96+
97+
<!-- prettier-ignore-start -->
98+
[npm]: https://www.npmjs.com/
99+
[node]: https://nodejs.org
100+
[git]: https://git-scm.com/
101+
[build-badge]: https://img.shields.io/github/actions/workflow/status/epicweb-dev/build-react-hooks/validate.yml?branch=main&logo=github&style=flat-square
102+
[build]: https://github.com/epicweb-dev/build-react-hooks/actions?query=workflow%3Avalidate
103+
[license-badge]: https://img.shields.io/badge/license-GPL%203.0%20License-blue.svg?style=flat-square
104+
[license]: https://github.com/epicweb-dev/build-react-hooks/blob/main/LICENSE
105+
[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square
106+
[coc]: https://kentcdodds.com/conduct
107+
[win-path]: https://www.howtogeek.com/118594/how-to-edit-your-system-path-for-easy-command-line-access/
108+
[mac-path]: http://stackoverflow.com/a/24322978/971592
109+
[issue]: https://github.com/epicweb-dev/build-react-hooks/issues/new
110+
<!-- prettier-ignore-end -->

‎epicshop/Dockerfile

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
FROM node:20-bookworm-slim as base
2+
3+
RUN apt-get update && apt-get install -y git
4+
5+
ENV EPICSHOP_CONTEXT_CWD="/myapp/workshop-content"
6+
ENV EPICSHOP_DEPLOYED="true"
7+
ENV EPICSHOP_DISABLE_WATCHER="true"
8+
ENV FLY="true"
9+
ENV PORT="8080"
10+
ENV NODE_ENV="production"
11+
12+
WORKDIR /myapp
13+
14+
ADD . .
15+
16+
RUN npm install --omit=dev
17+
18+
CMD rm -rf ${EPICSHOP_CONTEXT_CWD} && \
19+
git clone https://github.com/epicweb-dev/build-react-hooks ${EPICSHOP_CONTEXT_CWD} && \
20+
cd ${EPICSHOP_CONTEXT_CWD} && \
21+
npx epicshop start

‎epicshop/fix-watch.js

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
import path from 'node:path'
2+
import { fileURLToPath } from 'node:url'
3+
import chokidar from 'chokidar'
4+
import { $ } from 'execa'
5+
6+
const __dirname = path.dirname(fileURLToPath(import.meta.url))
7+
const here = (...p) => path.join(__dirname, ...p)
8+
9+
const workshopRoot = here('..')
10+
11+
const watchPath = path.join(workshopRoot, './exercises/*')
12+
const watcher = chokidar.watch(watchPath, {
13+
ignored: /(^|[\/\\])\../, // ignore dotfiles
14+
persistent: true,
15+
ignoreInitial: true,
16+
depth: 2,
17+
})
18+
19+
const debouncedRun = debounce(run, 200)
20+
21+
// Add event listeners.
22+
watcher
23+
.on('addDir', path => {
24+
debouncedRun()
25+
})
26+
.on('unlinkDir', path => {
27+
// Only act if path contains two slashes (excluding the leading `./`)
28+
debouncedRun()
29+
})
30+
.on('error', error => console.log(`Watcher error: ${error}`))
31+
32+
/**
33+
* Simple debounce implementation
34+
*/
35+
function debounce(fn, delay) {
36+
let timer = null
37+
return (...args) => {
38+
if (timer) clearTimeout(timer)
39+
timer = setTimeout(() => {
40+
fn(...args)
41+
}, delay)
42+
}
43+
}
44+
45+
let running = false
46+
47+
async function run() {
48+
if (running) {
49+
console.log('still running...')
50+
return
51+
}
52+
running = true
53+
try {
54+
await $({
55+
stdio: 'inherit',
56+
cwd: workshopRoot,
57+
})`node ./epicshop/fix.js`
58+
} catch (error) {
59+
throw error
60+
} finally {
61+
running = false
62+
}
63+
}
64+
65+
console.log(`watching ${watchPath}`)
66+
67+
// doing this because the watcher doesn't seem to work and I don't have time
68+
// to figure out why 🙃
69+
console.log('Polling...')
70+
setInterval(() => {
71+
run()
72+
}, 1000)
73+
74+
console.log('running fix to start...')
75+
run()

0 commit comments

Comments
 (0)