Flash cards
Review the key moves
What is the main idea behind Node.js package.json?
Lesson checks
Practice each idea before moving on
Short Mimo-style checks built from this lesson's code, terms, and sequence.
Which statement best captures the main point of this lesson?
Put the learning moves in the order that makes the concept easiest to apply.
What is package.json?
package.json is a special file that describes your Node.js project.
It contains information about your app, such as its name, version, dependencies, scripts, and more.
This file is essential for managing and sharing Node.js projects, especially when using npm (Node Package Manager).
Creating package.json
You can create a package.json file by running the following command in your project folder:
npm initThis command will ask you a series of questions about your project and generate a package.json file.
For a quick setup with default values, use:
npm init -yExample package.json
Here is a simple example of a package.json file:
{
"name": "my-node-app",
"version": "1.0.0",
"description": "A simple Node.js app",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"author": "Your Name",
"license": "ISC"
}This file describes the app, sets the main file to index.js , and defines a start script.
Adding Dependencies
When you install a package with npm, it is added to the dependencies section of package.json :
npm install expressThis command adds Express to your project and updates package.json automatically.
"dependencies": {
"express": "^5.1.0"
}Basic Metadata
{
"name": "my-package",
"version": "1.0.0",
"description": "A brief description of your package",
"main": "index.js",
"type": "module", // or "commonjs"
"keywords": ["example", "package", "node"],
"author": "Your Name ",
"license": "MIT",
"homepage": "https://example.com/my-package"
}Scripts
Define custom scripts that can be run with npm run <script-name> :
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js",
"test": "jest",
"build": "webpack --mode production",
"lint": "eslint .",
"prepare": "husky install"
}Dependencies
Specify project dependencies with version ranges
"dependencies": {
"express": "^4.18.2",
"mongoose": "~7.0.0",
"lodash": "4.17.21"
},Dev Dependencies
Development-only dependencies (not installed in production)
"devDependencies": {
"nodemon": "^2.0.22",
"jest": "^29.5.0",
"eslint": "^8.38.0"
}Version Ranges
- ^4.17.21 - Compatible with 4.x.x (up to but not including 5.0.0)
- ~4.17.21 - Patch updates only (4.17.x)
- 4.17.21 - Exact version
- latest - Latest stable version
- git+https://... - Git repository
Engines
Specify Node.js and npm version requirements:
"engines": {
"node": ">=14.0.0 <17.0.0",
"npm": ">=6.0.0"
}Repository and Bugs
"repository": {
"type": "git",
"url": "https://github.com/username/repo.git"
},
"bugs": {
"url": "https://github.com/username/repo/issues"
}Adding Dependencies
# Install and save to dependencies
npm install package-name
# Install and save to devDependencies
npm install --save-dev package-name
# Install exact version
npm install package-name@1.2.3Updating Dependencies
# Update a specific package
npm update package-name
# Update all packages
npm update
# Check for outdated packages
npm outdatedRunning Scripts
# Run a script
npm run script-name
# Run start script (can be called with just 'npm start')
npm start
# Run test script (can be called with just 'npm test')
npm testBest Practices
- Always specify exact versions in dependencies for production apps
- Use npm ci in CI/CD pipelines for reproducible builds
- Keep your package-lock.json file in version control
- Use .npmignore to exclude unnecessary files from published packages
- Regularly update dependencies to get security patches
Summary
package.json is the heart of any Node.js project, containing metadata, scripts, and dependency information.
Understanding its structure and fields is essential for effective Node.js development.