66597be8a7
### Reason for making this change https://yarnpkg.com/getting-started/qa#:~:text=yarn%2Finstall%2Dstate.,your%20workspaces%20all%20over%20again. In the official documentation of `yarn`, it is stated that `.yarn/install-state.gz` is an optimization file that developer shouldn't ever have to commit. However, currently, when running `create-next-app`, `.yarn/install-state.gz` is being commited. ### Remaining work I apologize for only modifying one template initially to initiate the discussion first. If this change is agreed upon, it should be synchronized with other `.gitignore` templates. Would it be possible to follow a similar approach as in https://github.com/vercel/next.js/pull/47241? I would appreciate any assistance in syncing this change. |
||
|---|---|---|
| .. | ||
| mocks | ||
| pages | ||
| public | ||
| .env.development | ||
| .env.production | ||
| .gitignore | ||
| next-env.d.ts | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
Mock Service Worker Example
Mock Service Worker is an API mocking library for browser and Node. It provides seamless mocking by interception of actual requests on the network level using Service Worker API. This makes your application unaware of any mocking being at place.
In this example we integrate Mock Service Worker with Next by following the next steps:
- Define a set of request handlers shared between client and server.
- Setup a Service Worker instance that would intercept all runtime client-side requests via
setupWorkerfunction. - Setup a "server" instance to intercept any server/build time requests (e.g. the one happening in
getServerSideProps) viasetupServerfunction.
Mocking is enabled using the NEXT_PUBLIC_API_MOCKING environment variable. By default, mocking is enabled for both development and production. This allows you to have working preview deployments before implementing an actual API. To disable MSW for a specific environment, change the environment variable value in the file corresponding to the environment from enabled to disabled.
The service worker file will automatically be generated in public/mockServiceWorker.js after installing node_modules. If the file is not generated, you can explicitly generate it with the following command:
npx msw init public/
More information on this setup step can be found in the MSW documentation here.
Deploy your own
Deploy the example using Vercel:
How to use
Execute create-next-app with npm, Yarn, or pnpm to bootstrap the example:
npx create-next-app --example with-msw with-msw-app
yarn create next-app --example with-msw with-msw-app
pnpm create next-app --example with-msw with-msw-app
Deploy it to the cloud with Vercel (Documentation).