Skip to content

docs: add minimal quick-start section to Getting Started guide#7904

Closed
pranjalisr wants to merge 56 commits intowebpack:mainfrom
pranjalisr:add/startguides
Closed

docs: add minimal quick-start section to Getting Started guide#7904
pranjalisr wants to merge 56 commits intowebpack:mainfrom
pranjalisr:add/startguides

Conversation

@pranjalisr
Copy link
Contributor

Summary
Fixes #7436
This PR adds a small “Quick Start (Minimal Example)” section at the top of the Getting Started guide.

What kind of change does this PR introduce?
Docs change

Did you add tests for your changes?
No

Does this PR introduce a breaking change?
No

If relevant, what needs to be documented once your changes are merged or what have you already documented?
N/A

Use of AI
N/A. Just docs change

@vercel
Copy link

vercel bot commented Mar 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
webpack-js-org Ready Ready Preview, Comment Mar 12, 2026 4:06pm

Request Review

Copy link
Member

@alexander-akait alexander-akait left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already have it on the main page

@pranjalisr
Copy link
Contributor Author

I tried adding minimal work setup as asked in PR #7436. So should I close this one ?

@alexander-akait
Copy link
Member

/cc @evenstensberg What do you think about this?

Copy link
Member

@evenstensberg evenstensberg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lets make use of create webpack app here.

@pranjalisr
Copy link
Contributor Author

so should I update the quick start via create webpack app ?

@pranjalisr
Copy link
Contributor Author

@evenstensberg Does this looks good?

Screenshot 2026-03-06 at 16 37 32

dependabot bot and others added 19 commits March 12, 2026 21:30
…ebpack#7905)

Bumps the dependencies group with 1 update: [cypress-io/github-action](https://github.com/cypress-io/github-action).


Updates `cypress-io/github-action` from 7.1.3 to 7.1.5
- [Release notes](https://github.com/cypress-io/github-action/releases)
- [Changelog](https://github.com/cypress-io/github-action/blob/master/CHANGELOG.md)
- [Commits](cypress-io/github-action@e44ee0f...bc22e01)

---
updated-dependencies:
- dependency-name: cypress-io/github-action
  dependency-version: 7.1.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [immutable](https://github.com/immutable-js/immutable-js) from 5.1.4 to 5.1.5.
- [Release notes](https://github.com/immutable-js/immutable-js/releases)
- [Changelog](https://github.com/immutable-js/immutable-js/blob/main/CHANGELOG.md)
- [Commits](immutable-js/immutable-js@v5.1.4...v5.1.5)

---
updated-dependencies:
- dependency-name: immutable
  dependency-version: 5.1.5
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps the dependencies group with 2 updates: [actions/dependency-review-action](https://github.com/actions/dependency-review-action) and [actions/setup-node](https://github.com/actions/setup-node).


Updates `actions/dependency-review-action` from 4.8.3 to 4.9.0
- [Release notes](https://github.com/actions/dependency-review-action/releases)
- [Commits](actions/dependency-review-action@05fe457...2031cfc)

Updates `actions/setup-node` from 6.2.0 to 6.3.0
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](actions/setup-node@6044e13...53b8394)

---
updated-dependencies:
- dependency-name: actions/dependency-review-action
  dependency-version: 4.9.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: actions/setup-node
  dependency-version: 6.3.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…12 updates (webpack#7919)

Bumps the dependencies group with 12 updates in the / directory:

| Package | From | To |
| --- | --- | --- |
| [autoprefixer](https://github.com/postcss/autoprefixer) | `10.4.24` | `10.4.27` |
| [css-loader](https://github.com/webpack/css-loader) | `7.1.3` | `7.1.4` |
| [cypress](https://github.com/cypress-io/cypress) | `15.9.0` | `15.11.0` |
| [eslint-plugin-mdx](https://github.com/mdx-js/eslint-mdx) | `3.6.2` | `3.7.0` |
| [globals](https://github.com/sindresorhus/globals) | `17.3.0` | `17.4.0` |
| [lint-staged](https://github.com/lint-staged/lint-staged) | `16.2.7` | `16.3.2` |
| [markdownlint-cli](https://github.com/igorshubovych/markdownlint-cli) | `0.47.0` | `0.48.0` |
| [postcss](https://github.com/postcss/postcss) | `8.5.6` | `8.5.8` |
| [postcss-loader](https://github.com/webpack/postcss-loader) | `8.2.0` | `8.2.1` |
| [rimraf](https://github.com/isaacs/rimraf) | `6.1.2` | `6.1.3` |
| [sass-loader](https://github.com/webpack/sass-loader) | `16.0.6` | `16.0.7` |
| [webpack](https://github.com/webpack/webpack) | `5.105.0` | `5.105.4` |



Updates `autoprefixer` from 10.4.24 to 10.4.27
- [Release notes](https://github.com/postcss/autoprefixer/releases)
- [Changelog](https://github.com/postcss/autoprefixer/blob/main/CHANGELOG.md)
- [Commits](postcss/autoprefixer@10.4.24...10.4.27)

Updates `css-loader` from 7.1.3 to 7.1.4
- [Release notes](https://github.com/webpack/css-loader/releases)
- [Changelog](https://github.com/webpack/css-loader/blob/main/CHANGELOG.md)
- [Commits](webpack/css-loader@v7.1.3...v7.1.4)

Updates `cypress` from 15.9.0 to 15.11.0
- [Release notes](https://github.com/cypress-io/cypress/releases)
- [Changelog](https://github.com/cypress-io/cypress/blob/develop/CHANGELOG.md)
- [Commits](cypress-io/cypress@v15.9.0...v15.11.0)

Updates `eslint-plugin-mdx` from 3.6.2 to 3.7.0
- [Release notes](https://github.com/mdx-js/eslint-mdx/releases)
- [Changelog](https://github.com/mdx-js/eslint-mdx/blob/master/CHANGELOG.md)
- [Commits](https://github.com/mdx-js/eslint-mdx/compare/eslint-plugin-mdx@3.6.2...eslint-plugin-mdx@3.7.0)

Updates `globals` from 17.3.0 to 17.4.0
- [Release notes](https://github.com/sindresorhus/globals/releases)
- [Commits](sindresorhus/globals@v17.3.0...v17.4.0)

Updates `lint-staged` from 16.2.7 to 16.3.2
- [Release notes](https://github.com/lint-staged/lint-staged/releases)
- [Changelog](https://github.com/lint-staged/lint-staged/blob/main/CHANGELOG.md)
- [Commits](lint-staged/lint-staged@v16.2.7...v16.3.2)

Updates `markdownlint-cli` from 0.47.0 to 0.48.0
- [Release notes](https://github.com/igorshubovych/markdownlint-cli/releases)
- [Commits](igorshubovych/markdownlint-cli@v0.47.0...v0.48.0)

Updates `postcss` from 8.5.6 to 8.5.8
- [Release notes](https://github.com/postcss/postcss/releases)
- [Changelog](https://github.com/postcss/postcss/blob/main/CHANGELOG.md)
- [Commits](postcss/postcss@8.5.6...8.5.8)

Updates `postcss-loader` from 8.2.0 to 8.2.1
- [Release notes](https://github.com/webpack/postcss-loader/releases)
- [Changelog](https://github.com/webpack/postcss-loader/blob/main/CHANGELOG.md)
- [Commits](webpack/postcss-loader@v8.2.0...v8.2.1)

Updates `rimraf` from 6.1.2 to 6.1.3
- [Changelog](https://github.com/isaacs/rimraf/blob/main/CHANGELOG.md)
- [Commits](isaacs/rimraf@v6.1.2...v6.1.3)

Updates `sass-loader` from 16.0.6 to 16.0.7
- [Release notes](https://github.com/webpack/sass-loader/releases)
- [Changelog](https://github.com/webpack/sass-loader/blob/main/CHANGELOG.md)
- [Commits](webpack/sass-loader@v16.0.6...v16.0.7)

Updates `webpack` from 5.105.0 to 5.105.4
- [Release notes](https://github.com/webpack/webpack/releases)
- [Changelog](https://github.com/webpack/webpack/blob/main/CHANGELOG.md)
- [Commits](webpack/webpack@v5.105.0...v5.105.4)

---
updated-dependencies:
- dependency-name: autoprefixer
  dependency-version: 10.4.27
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: css-loader
  dependency-version: 7.1.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: cypress
  dependency-version: 15.11.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: eslint-plugin-mdx
  dependency-version: 3.7.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: globals
  dependency-version: 17.4.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: lint-staged
  dependency-version: 16.3.2
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: markdownlint-cli
  dependency-version: 0.48.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: dependencies
- dependency-name: postcss
  dependency-version: 8.5.8
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: postcss-loader
  dependency-version: 8.2.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: rimraf
  dependency-version: 6.1.3
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: sass-loader
  dependency-version: 16.0.7
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
- dependency-name: webpack
  dependency-version: 5.105.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…pack#7927)

Removed margin from footer items and applied it to the parent container for consistent spacing.
The cache.keys().then() chain inside the activate event handler
was not being returned, so event.waitUntil() resolved immediately
with undefined before any stale cache entries were deleted.

This meant old cache entries from previous deployments would
accumulate in users' browsers silently with no guarantee of cleanup.

Fix by returning the inner promise chain and using Promise.all()
to delete stale entries in parallel, ensuring event.waitUntil()
only resolves once all deletions are complete.
Katari-8055 and others added 21 commits March 12, 2026 21:30
The linkFixer function had two bugs:
1. href.replace('//www.npmjs.com') was called with no second argument,
   causing .replace() to substitute the match with the string 'undefined',
   producing malformed URLs like 'https:undefined/package/foo'.
2. The search string '//www.npmjs.com' would never match the condition
   href.includes('//npmjs.com'), making the branch unreachable for www URLs.

Fix: replace('//npmjs.com', '//www.npmjs.com') — normalizes bare npmjs.com
links to www.npmjs.com without corrupting any URLs.
…ack#7952)

Bumps [copy-webpack-plugin](https://github.com/webpack/copy-webpack-plugin) from 13.0.1 to 14.0.0.
- [Release notes](https://github.com/webpack/copy-webpack-plugin/releases)
- [Changelog](https://github.com/webpack/copy-webpack-plugin/blob/main/CHANGELOG.md)
- [Commits](webpack/copy-webpack-plugin@v13.0.1...v14.0.0)

---
updated-dependencies:
- dependency-name: copy-webpack-plugin
  dependency-version: 14.0.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Add aria-hidden='true' to decorative SVG elements in src/components/HelloDarkness.jsx so screen readers ignore the icons. This prevents unnecessary announcements of decorative graphics and improves accessibility.
webpack#7953)

Bumps [css-minimizer-webpack-plugin](https://github.com/webpack/css-minimizer-webpack-plugin) from 7.0.4 to 8.0.0.
- [Release notes](https://github.com/webpack/css-minimizer-webpack-plugin/releases)
- [Changelog](https://github.com/webpack/css-minimizer-webpack-plugin/blob/main/CHANGELOG.md)
- [Commits](webpack/css-minimizer-webpack-plugin@v7.0.4...v8.0.0)

---
updated-dependencies:
- dependency-name: css-minimizer-webpack-plugin
  dependency-version: 8.0.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…ack#7951)

Bumps [eslint-plugin-cypress](https://github.com/cypress-io/eslint-plugin-cypress) from 5.2.1 to 6.1.0.
- [Release notes](https://github.com/cypress-io/eslint-plugin-cypress/releases)
- [Commits](cypress-io/eslint-plugin-cypress@v5.2.1...v6.1.0)

---
updated-dependencies:
- dependency-name: eslint-plugin-cypress
  dependency-version: 6.1.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
webpack#7982)

* docs(guides): add import.defer() context module example to lazy loading guide

* docs(guides): fix eslint error and address maintainer review on closing sentence

* docs(guides): use text fence for import.defer() block to fix eslint parse error
@pranjalisr pranjalisr marked this pull request as draft March 12, 2026 16:00
@pranjalisr pranjalisr force-pushed the add/startguides branch 2 times, most recently from a5b80cc to 75c6432 Compare March 12, 2026 16:03
@pranjalisr
Copy link
Contributor Author

closed due to unwanted commits

@evenstensberg
Copy link
Member

Open a new pr on a fresh branch if you have rebase problems. Its much easier.

@pranjalisr
Copy link
Contributor Author

Open a new pr on a fresh branch if you have rebase problems. Its much easier.

I have opened fresh PR #7995 for the same issue, and all test cases are passing. Please review #7995

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

The "Getting Started Guide" is too slow to get to a minimal working state