Two ways to install dependencies from package.json
📦 Node.js-> Command Line
✨ The Prompt Phrase
npm install npm ci
💻 Code Preview
📦 All-in-One Code
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Two ways to install dependencies from package.json - Interactive Tutorial</title>
<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;600;700;900&family=Fira+Code:wght@400;500;600&display=swap" rel="stylesheet">
<style>
:root {
--bg-primary: #0a0e27;
--bg-secondary: #151932;
--bg-card: #1e2139;
--accent-purple: #a855f7;
--accent-blue: #3b82f6;
--accent-green: #10b981;
--accent-red: #ef4444;
--accent-yellow: #f59e0b;
--accent-pink: #ec4899;
--accent-cyan: #06b6d4;
--accent-orange: #f97316;
--text-primary: #f8fafc;
--text-secondary: #94a3b8;
--gradient-install: linear-gradient(135deg, #3b82f6 0%, #8b5cf6 100%);
--gradient-ci: linear-gradient(135deg, #10b981 0%, #059669 100%);
--gradient-both: linear-gradient(135deg, #3b82f6 0%, #10b981 100%);
--shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
}
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: 'Poppins', sans-serif;
background: var(--bg-primary);
color: var(--text-primary);
line-height: 1.6;
overflow-x: hidden;
}
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
.progress-container {
position: fixed;
top: 0;
left: 0;
width: 100%;
height: 5px;
background: var(--bg-secondary);
z-index: 1000;
}
.progress-bar {
height: 100%;
background: var(--gradient-both);
width: 0%;
transition: width 0.3s ease;
}
.hero {
text-align: center;
padding: 100px 20px;
background: var(--gradient-both);
position: relative;
overflow: hidden;
border-radius: 0 0 50px 50px;
}
.hero::before {
content: '';
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
background: url('data:image/svg+xml,<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg"><circle cx="50" cy="50" r="2" fill="white" opacity="0.1"/></svg>');
animation: float 20s linear infinite;
}
@keyframes float {
from { transform: translateY(0); }
to { transform: translateY(-100px); }
}
.hero-content {
position: relative;
z-index: 1;
}
.vs-icon {
font-size: 5rem;
margin-bottom: 20px;
animation: vsSwing 3s ease-in-out infinite;
}
@keyframes vsSwing {
0%, 100% { transform: rotate(-5deg) scale(1); }
50% { transform: rotate(5deg) scale(1.1); }
}
.command-display {
display: inline-block;
background: rgba(0, 0, 0, 0.4);
padding: 25px 40px;
border-radius: 15px;
font-family: 'Fira Code', monospace;
font-size: 1.3rem;
margin: 30px 0;
border: 3px solid rgba(255, 255, 255, 0.3);
color: white;
font-weight: 600;
}
.command-line {
margin: 5px 0;
}
.hero h1 {
font-size: 3.5rem;
font-weight: 900;
margin-bottom: 20px;
color: white;
text-shadow: 2px 2px 4px rgba(0,0,0,0.3);
}
.hero p {
font-size: 1.4rem;
opacity: 0.95;
color: white;
}
.section {
margin: 60px 0;
}
.section-title {
font-size: 2.5rem;
margin-bottom: 30px;
background: var(--gradient-both);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
display: inline-block;
font-weight: 700;
}
.card {
background: var(--bg-card);
border-radius: 20px;
padding: 40px;
margin: 30px 0;
box-shadow: var(--shadow);
border: 1px solid rgba(255, 255, 255, 0.05);
transition: transform 0.3s ease;
}
.card:hover {
transform: translateY(-5px);
}
.code-block {
background: #1e1e1e;
border-radius: 15px;
padding: 25px;
margin: 20px 0;
font-family: 'Fira Code', monospace;
position: relative;
}
.code-header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 15px;
padding-bottom: 15px;
border-bottom: 1px solid rgba(255, 255, 255, 0.1);
}
.terminal-dots {
display: flex;
gap: 6px;
}
.terminal-dot {
width: 12px;
height: 12px;
border-radius: 50%;
}
.dot-red { background: #ff5f56; }
.dot-yellow { background: #ffbd2e; }
.dot-green { background: #27c93f; }
.copy-btn {
background: var(--accent-purple);
color: white;
border: none;
padding: 8px 16px;
border-radius: 8px;
cursor: pointer;
font-size: 0.9rem;
transition: all 0.3s ease;
}
.copy-btn:hover {
background: var(--accent-blue);
transform: scale(1.05);
}
.copy-btn.copied {
background: var(--accent-green);
}
pre {
margin: 0;
overflow-x: auto;
}
code {
color: #e0e0e0;
font-size: 0.95rem;
line-height: 1.8;
}
.code-comment { color: #6a9955; }
.code-string { color: #ce9178; }
.code-keyword { color: #569cd6; }
.code-install { color: #3b82f6; font-weight: 600; }
.code-ci { color: #10b981; font-weight: 600; }
.code-npm { color: #cb3837; font-weight: 600; }
.steps {
counter-reset: step-counter;
}
.step {
background: var(--bg-secondary);
border-radius: 15px;
padding: 30px;
margin: 20px 0;
position: relative;
padding-left: 100px;
transition: all 0.3s ease;
}
.step:hover {
background: var(--bg-card);
transform: translateX(10px);
}
.step::before {
counter-increment: step-counter;
content: counter(step-counter);
position: absolute;
left: 20px;
top: 50%;
transform: translateY(-50%);
width: 60px;
height: 60px;
background: var(--gradient-both);
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
font-size: 1.8rem;
font-weight: 900;
color: white;
}
.step h3 {
color: var(--accent-cyan);
margin-bottom: 10px;
font-size: 1.5rem;
}
.feature-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 25px;
margin: 30px 0;
}
.feature-card {
background: var(--bg-secondary);
padding: 30px;
border-radius: 15px;
text-align: center;
transition: all 0.3s ease;
border: 2px solid transparent;
}
.feature-card:hover {
border-color: var(--accent-cyan);
transform: translateY(-10px);
}
.feature-icon {
font-size: 3.5rem;
margin-bottom: 15px;
}
.feature-title {
font-weight: 600;
color: var(--accent-cyan);
margin-bottom: 10px;
font-size: 1.3rem;
}
.demo-container {
background: var(--bg-secondary);
border-radius: 20px;
padding: 40px;
margin: 30px 0;
}
.comparison-table {
width: 100%;
border-collapse: separate;
border-spacing: 0 10px;
margin: 30px 0;
}
.comparison-table th {
background: var(--bg-card);
padding: 20px;
text-align: left;
font-weight: 600;
border-radius: 10px;
}
.comparison-table td {
background: var(--bg-secondary);
padding: 20px;
border-top: 1px solid rgba(255, 255, 255, 0.05);
}
.comparison-table tr:hover td {
background: var(--bg-card);
}
.install-col { color: var(--accent-blue); }
.ci-col { color: var(--accent-green); }
.terminal {
background: #1e1e1e;
border-radius: 15px;
padding: 20px;
font-family: 'Fira Code', monospace;
min-height: 250px;
margin: 20px 0;
overflow-y: auto;
max-height: 500px;
}
.terminal-line {
margin: 10px 0;
}
.terminal-prompt {
color: var(--accent-green);
}
.demo-button {
background: var(--gradient-both);
color: white;
border: none;
padding: 15px 40px;
border-radius: 50px;
font-size: 1.1rem;
font-weight: 600;
cursor: pointer;
transition: all 0.3s ease;
display: inline-flex;
align-items: center;
gap: 10px;
margin: 10px;
}
.demo-button:hover {
transform: scale(1.05);
box-shadow: 0 10px 30px rgba(59, 130, 246, 0.4);
}
.tabs {
display: flex;
gap: 10px;
margin-bottom: 20px;
flex-wrap: wrap;
}
.tab {
padding: 12px 24px;
background: var(--bg-secondary);
border: none;
border-radius: 10px;
color: var(--text-primary);
cursor: pointer;
transition: all 0.3s ease;
font-size: 1rem;
}
.tab:hover {
background: var(--bg-card);
}
.tab.active {
background: var(--gradient-both);
color: white;
}
.tab-content {
display: none;
}
.tab-content.active {
display: block;
}
.accordion-header {
cursor: pointer;
display: flex;
justify-content: space-between;
align-items: center;
padding: 20px;
background: var(--bg-secondary);
border-radius: 12px;
margin: 15px 0;
transition: all 0.3s ease;
}
.accordion-header:hover {
background: var(--bg-card);
}
.accordion-icon {
transition: transform 0.3s ease;
font-size: 1.2rem;
}
.accordion-icon.active {
transform: rotate(180deg);
}
.accordion-content {
max-height: 0;
overflow: hidden;
transition: max-height 0.3s ease;
}
.accordion-content.active {
max-height: 2000px;
}
.accordion-body {
padding: 20px;
background: var(--bg-secondary);
border-radius: 12px;
margin-top: 5px;
}
.tip, .warning, .success, .info {
padding: 20px;
border-radius: 10px;
margin: 20px 0;
}
.tip {
background: rgba(59, 130, 246, 0.1);
border-left: 4px solid var(--accent-blue);
}
.tip::before { content: '💡 '; font-size: 1.5rem; }
.warning {
background: rgba(239, 68, 68, 0.1);
border-left: 4px solid var(--accent-red);
}
.warning::before { content: '⚠️ '; font-size: 1.5rem; }
.success {
background: rgba(16, 185, 129, 0.1);
border-left: 4px solid var(--accent-green);
}
.success::before { content: '✅ '; font-size: 1.5rem; }
.info {
background: rgba(236, 72, 153, 0.1);
border-left: 4px solid var(--accent-pink);
}
.info::before { content: '🔍 '; font-size: 1.5rem; }
.quiz-container {
background: var(--bg-card);
border-radius: 20px;
padding: 40px;
margin: 30px 0;
}
.quiz-question {
margin: 30px 0;
}
.quiz-question h3 {
color: var(--accent-purple);
margin-bottom: 20px;
font-size: 1.3rem;
}
.quiz-options {
display: flex;
flex-direction: column;
gap: 15px;
}
.quiz-option {
background: var(--bg-secondary);
padding: 20px;
border-radius: 12px;
cursor: pointer;
transition: all 0.3s ease;
border: 2px solid transparent;
}
.quiz-option:hover {
border-color: var(--accent-blue);
transform: translateX(10px);
}
.quiz-option.correct {
border-color: var(--accent-green);
background: rgba(16, 185, 129, 0.1);
}
.quiz-option.incorrect {
border-color: var(--accent-red);
background: rgba(239, 68, 68, 0.1);
}
.quiz-feedback {
margin-top: 15px;
padding: 15px;
border-radius: 10px;
display: none;
}
.quiz-feedback.show {
display: block;
}
.quiz-feedback.correct {
background: rgba(16, 185, 129, 0.1);
border-left: 4px solid var(--accent-green);
}
.quiz-feedback.incorrect {
background: rgba(239, 68, 68, 0.1);
border-left: 4px solid var(--accent-red);
}
.cheat-sheet {
background: var(--gradient-both);
border-radius: 20px;
padding: 40px;
margin: 30px 0;
color: white;
}
.cheat-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 20px;
margin-top: 30px;
}
.cheat-item {
background: rgba(255, 255, 255, 0.15);
backdrop-filter: blur(10px);
padding: 20px;
border-radius: 15px;
border: 1px solid rgba(255, 255, 255, 0.2);
}
.cheat-item h4 {
color: white;
margin-bottom: 10px;
font-weight: 600;
}
.cheat-item code {
background: rgba(0, 0, 0, 0.3);
padding: 4px 8px;
border-radius: 5px;
font-size: 0.9rem;
color: white;
}
.highlight {
color: var(--accent-yellow);
font-weight: 600;
}
.footer {
text-align: center;
padding: 40px 20px;
background: var(--bg-secondary);
margin-top: 80px;
border-radius: 20px;
}
.footer p {
color: var(--text-secondary);
margin: 10px 0;
}
.badge {
display: inline-block;
padding: 6px 12px;
background: var(--gradient-both);
border-radius: 20px;
font-size: 0.85rem;
font-weight: 600;
margin: 5px;
}
.confetti {
position: fixed;
width: 10px;
height: 10px;
background: var(--accent-blue);
animation: confetti-fall 3s linear forwards;
z-index: 9999;
}
@keyframes confetti-fall {
to {
transform: translateY(100vh) rotate(360deg);
opacity: 0;
}
}
@media (max-width: 768px) {
.hero h1 { font-size: 2rem; }
.command-display { font-size: 1rem; padding: 15px 20px; }
.section-title { font-size: 1.8rem; }
.card { padding: 25px; }
.step { padding-left: 80px; }
.step::before { width: 50px; height: 50px; font-size: 1.5rem; }
.comparison-table { font-size: 0.9rem; }
}
</style>
</head>
<body>
<div class="progress-container">
<div class="progress-bar" id="progressBar"></div>
</div>
<div class="hero">
<div class="hero-content">
<div class="vs-icon">⚔️</div>
<h1>npm install vs npm ci!</h1>
<div class="command-display">
<div class="command-line">npm install</div>
<div class="command-line">npm ci</div>
</div>
<p>Two Ways, Different Powers! 🚀</p>
</div>
</div>
<div class="container">
<!-- What Is It -->
<section class="section">
<h2 class="section-title">🤔 What's the Difference?</h2>
<div class="card">
<p style="font-size: 1.2rem; margin-bottom: 20px;">
Both commands <span class="highlight">install dependencies</span> from package.json, but they work differently! Think of <code>npm install</code> as the flexible friend and <code>npm ci</code> as the strict enforcer! 🎭
</p>
<p style="margin-bottom: 30px;">
Imagine you're building with LEGO blocks! 🧱 <code>npm install</code> lets you swap pieces and update the instruction manual as you go. <code>npm ci</code> follows the exact instructions, no improvising - it's perfect for when you need everything to be exactly the same!
</p>
<table class="comparison-table">
<thead>
<tr>
<th style="width: 30%;">Feature</th>
<th class="install-col">npm install</th>
<th class="ci-col">npm ci</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Speed</strong></td>
<td class="install-col">Slower ⏱️</td>
<td class="ci-col">Faster ⚡</td>
</tr>
<tr>
<td><strong>Updates Lock File</strong></td>
<td class="install-col">Yes ✅</td>
<td class="ci-col">No ❌</td>
</tr>
<tr>
<td><strong>Requires Lock File</strong></td>
<td class="install-col">No ❌</td>
<td class="ci-col">Yes ✅</td>
</tr>
<tr>
<td><strong>Deletes node_modules</strong></td>
<td class="install-col">No ❌</td>
<td class="ci-col">Yes ✅</td>
</tr>
<tr>
<td><strong>Best For</strong></td>
<td class="install-col">Development 💻</td>
<td class="ci-col">CI/CD & Production 🏭</td>
</tr>
<tr>
<td><strong>Reproducibility</strong></td>
<td class="install-col">Good 👍</td>
<td class="ci-col">Perfect 🎯</td>
</tr>
</tbody>
</table>
<div class="info" style="margin-top: 30px;">
<strong>Quick Rule:</strong> Use <code>npm install</code> when developing, <code>npm ci</code> for automated builds!
</div>
</div>
</section>
<!-- Why Use Each -->
<section class="section">
<h2 class="section-title">✨ When to Use Each?</h2>
<div class="card">
<div class="feature-grid">
<div class="feature-card" style="border: 2px solid var(--accent-blue);">
<div class="feature-icon">💻</div>
<div class="feature-title" style="color: var(--accent-blue);">npm install</div>
<p style="color: var(--text-secondary); margin-top: 10px;">
• Local development<br>
• Adding new packages<br>
• Updating dependencies<br>
• Flexible workflow
</p>
</div>
<div class="feature-card" style="border: 2px solid var(--accent-green);">
<div class="feature-icon">🏭</div>
<div class="feature-title" style="color: var(--accent-green);">npm ci</div>
<p style="color: var(--text-secondary); margin-top: 10px;">
• CI/CD pipelines<br>
• Production deploys<br>
• Automated testing<br>
• Exact reproducibility
</p>
</div>
</div>
</div>
</section>
<!-- How They Work -->
<section class="section">
<h2 class="section-title">⚙️ How Do They Work?</h2>
<div class="card">
<h3 style="color: var(--accent-blue); margin-bottom: 20px;">📦 npm install Process</h3>
<div class="steps">
<div class="step">
<h3>Step 1: Read Files</h3>
<p>Reads both package.json and package-lock.json (if exists).</p>
</div>
<div class="step">
<h3>Step 2: Resolve Versions</h3>
<p>Figures out which versions to install (may update).</p>
</div>
<div class="step">
<h3>Step 3: Install Packages</h3>
<p>Downloads and installs into node_modules.</p>
</div>
<div class="step">
<h3>Step 4: Update Lock File</h3>
<p>Updates package-lock.json with new versions.</p>
</div>
</div>
<h3 style="color: var(--accent-green); margin-top: 40px; margin-bottom: 20px;">🎯 npm ci Process</h3>
<div class="steps">
<div class="step">
<h3>Step 1: Check Lock File</h3>
<p>Requires package-lock.json to exist (fails without it).</p>
</div>
<div class="step">
<h3>Step 2: Delete node_modules</h3>
<p>Completely removes existing node_modules folder.</p>
</div>
<div class="step">
<h3>Step 3: Install Exact Versions</h3>
<p>Installs EXACT versions from lock file only.</p>
</div>
<div class="step">
<h3>Step 4: Never Updates Lock</h3>
<p>Lock file stays unchanged - perfect reproducibility!</p>
</div>
</div>
</div>
</section>
<!-- Live Demo -->
<section class="section">
<h2 class="section-title">🎮 Interactive Demo</h2>
<div class="demo-container">
<div style="margin-bottom: 30px; text-align: center;">
<h4 style="margin-bottom: 15px;">See Both Commands in Action! ⚔️</h4>
<button class="demo-button" onclick="simulateInstall()">
<span>💻</span>
<span>npm install</span>
</button>
<button class="demo-button" onclick="simulateCi()">
<span>🏭</span>
<span>npm ci</span>
</button>
<button class="demo-button" onclick="simulateComparison()">
<span>⚔️</span>
<span>Compare Both</span>
</button>
</div>
<div class="terminal" id="terminal">
<div class="terminal-line">
<span class="terminal-prompt">$</span>
<span style="color: var(--text-secondary);"> Ready to compare install methods...</span>
</div>
</div>
</div>
</section>
<!-- Code Examples -->
<section class="section">
<h2 class="section-title">💻 Usage Examples</h2>
<div class="card">
<div class="tabs">
<button class="tab active" onclick="switchTab('basic')">Basic Usage</button>
<button class="tab" onclick="switchTab('scenarios')">Use Cases</button>
<button class="tab" onclick="switchTab('cicd')">CI/CD</button>
<button class="tab" onclick="switchTab('troubleshoot')">Troubleshooting</button>
</div>
<div id="basic" class="tab-content active">
<h3 style="color: var(--accent-pink); margin-bottom: 15px;">Basic Commands</h3>
<div class="code-block">
<div class="code-header">
<div class="terminal-dots">
<div class="terminal-dot dot-red"></div>
<div class="terminal-dot dot-yellow"></div>
<div class="terminal-dot dot-green"></div>
</div>
<button class="copy-btn" onclick="copyCode('basic-code')">📋 Copy</button>
</div>
<pre><code id="basic-code"><span class="code-comment"># npm install - Development</span>
npm install
<span class="code-comment"># Installs from package.json, updates lock file</span>
<span class="code-comment"># npm ci - Production/CI</span>
npm ci
<span class="code-comment"># Installs from lock file, never modifies it</span>
<span class="code-comment"># Key differences:</span>
<span class="code-comment"># npm install:</span>
<span class="code-comment"># - Can update package-lock.json</span>
<span class="code-comment"># - Works without lock file</span>
<span class="code-comment"># - Keeps existing node_modules</span>
<span class="code-comment"># npm ci:</span>
<span class="code-comment"># - Requires package-lock.json</span>
<span class="code-comment"># - Deletes node_modules first</span>
<span class="code-comment"># - Faster and more reliable</span>
<span class="code-comment"># - Perfect for CI/CD</span></code></pre>
</div>
</div>
<div id="scenarios" class="tab-content">
<h3 style="color: var(--accent-pink); margin-bottom: 15px;">When to Use Each</h3>
<div class="code-block">
<div class="code-header">
<div class="terminal-dots">
<div class="terminal-dot dot-red"></div>
<div class="terminal-dot dot-yellow"></div>
<div class="terminal-dot dot-green"></div>
</div>
<button class="copy-btn" onclick="copyCode('scenarios-code')">📋 Copy</button>
</div>
<pre><code id="scenarios-code"><span class="code-comment"># Scenario 1: Starting a new project</span>
git clone repo
npm install <span class="code-comment"># Use install for first setup</span>
<span class="code-comment"># Scenario 2: Adding a new package</span>
npm install express
<span class="code-comment"># Adds to package.json and updates lock file</span>
<span class="code-comment"># Scenario 3: After git pull</span>
git pull
npm install <span class="code-comment"># Updates if package.json changed</span>
<span class="code-comment"># Scenario 4: CI/CD pipeline</span>
npm ci <span class="code-comment"># Always use ci in automation!</span>
<span class="code-comment"># Scenario 5: Production deployment</span>
npm ci --production
<span class="code-comment"># Only production deps, exact versions</span>
<span class="code-comment"># Scenario 6: Fresh clean install</span>
rm -rf node_modules
npm ci <span class="code-comment"># Guaranteed clean state</span>
<span class="code-comment"># Scenario 7: Debugging dependency issues</span>
npm ci <span class="code-comment"># Ensures exact versions from lock</span>
<span class="code-comment"># Scenario 8: Team collaboration</span>
<span class="code-comment"># Everyone runs: npm ci</span>
<span class="code-comment"># Ensures everyone has same versions!</span></code></pre>
</div>
</div>
<div id="cicd" class="tab-content">
<h3 style="color: var(--accent-pink); margin-bottom: 15px;">CI/CD Examples</h3>
<div class="code-block">
<div class="code-header">
<div class="terminal-dots">
<div class="terminal-dot dot-red"></div>
<div class="terminal-dot dot-yellow"></div>
<div class="terminal-dot dot-green"></div>
</div>
<button class="copy-btn" onclick="copyCode('cicd-code')">📋 Copy</button>
</div>
<pre><code id="cicd-code"><span class="code-comment"># GitHub Actions</span>
name: CI
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
- run: npm ci <span class="code-comment"># Always use ci!</span>
- run: npm test
<span class="code-comment"># GitLab CI</span>
test:
script:
- npm ci
- npm run test
<span class="code-comment"># Docker</span>
FROM node:18
WORKDIR /app
COPY package*.json ./
RUN npm ci --production <span class="code-comment"># Production only</span>
COPY . .
CMD [<span class="code-string">"npm"</span>, <span class="code-string">"start"</span>]
<span class="code-comment"># Jenkins</span>
stage(<span class="code-string">'Install'</span>) {
steps {
sh <span class="code-string">'npm ci'</span>
}
}
<span class="code-comment"># package.json scripts</span>
{
<span class="code-string">"scripts"</span>: {
<span class="code-string">"ci"</span>: <span class="code-string">"npm ci"</span>,
<span class="code-string">"ci:test"</span>: <span class="code-string">"npm ci && npm test"</span>,
<span class="code-string">"ci:prod"</span>: <span class="code-string">"npm ci --production"</span>
}
}</code></pre>
</div>
</div>
<div id="troubleshoot" class="tab-content">
<h3 style="color: var(--accent-pink); margin-bottom: 15px;">Common Issues & Fixes</h3>
<div class="code-block">
<div class="code-header">
<div class="terminal-dots">
<div class="terminal-dot dot-red"></div>
<div class="terminal-dot dot-yellow"></div>
<div class="terminal-dot dot-green"></div>
</div>
<button class="copy-btn" onclick="copyCode('troubleshoot-code')">📋 Copy</button>
</div>
<pre><code id="troubleshoot-code"><span class="code-comment"># Problem: npm ci fails - no lock file</span>
<span class="code-comment"># Solution: Generate lock file first</span>
npm install <span class="code-comment"># Creates package-lock.json</span>
git add package-lock.json
git commit -m <span class="code-string">"Add lock file"</span>
<span class="code-comment"># Problem: Lock file out of sync</span>
<span class="code-comment"># Solution: Regenerate lock file</span>
rm package-lock.json
npm install
npm ci <span class="code-comment"># Now works!</span>
<span class="code-comment"># Problem: Different versions on team</span>
<span class="code-comment"># Solution: Everyone use npm ci</span>
npm ci <span class="code-comment"># Exact same versions for all</span>
<span class="code-comment"># Problem: Slow CI builds</span>
<span class="code-comment"># Solution: Use npm ci (faster than install)</span>
npm ci <span class="code-comment"># Up to 2x faster!</span>
<span class="code-comment"># Problem: Corrupted node_modules</span>
<span class="code-comment"># Solution: Fresh install with ci</span>
npm ci <span class="code-comment"># Deletes and reinstalls cleanly</span>
<span class="code-comment"># Problem: Want to update packages</span>
<span class="code-comment"># Solution: Use install, not ci</span>
npm install <span class="code-comment"># Updates within semver ranges</span>
npm update <span class="code-comment"># Or explicitly update</span></code></pre>
</div>
</div>
</div>
</section>
<!-- Common Mistakes -->
<section class="section">
<h2 class="section-title">❌ Common Mistakes</h2>
<div class="card">
<div class="accordion">
<div class="accordion-item">
<div class="accordion-header" onclick="toggleAccordion(this)">
<span><strong>1. Using npm install in CI/CD</strong></span>
<span class="accordion-icon">▼</span>
</div>
<div class="accordion-content">
<div class="accordion-body">
<div class="warning">
<strong>Problem:</strong> <code>npm install</code> can produce different results each time
</div>
<div class="success" style="margin-top: 15px;">
<strong>Solution:</strong> Always use <code>npm ci</code> in CI/CD for reproducibility!
</div>
</div>
</div>
</div>
<div class="accordion-item">
<div class="accordion-header" onclick="toggleAccordion(this)">
<span><strong>2. Not Committing package-lock.json</strong></span>
<span class="accordion-icon">▼</span>
</div>
<div class="accordion-content">
<div class="accordion-body">
<div class="warning">
<strong>Problem:</strong> Without lock file, <code>npm ci</code> fails
</div>
<div class="success" style="margin-top: 15px;">
<strong>Solution:</strong> Always commit package-lock.json to version control!
</div>
</div>
</div>
</div>
<div class="accordion-item">
<div class="accordion-header" onclick="toggleAccordion(this)">
<span><strong>3. Using npm ci for Development</strong></span>
<span class="accordion-icon">▼</span>
</div>
<div class="accordion-content">
<div class="accordion-body">
<div class="warning">
<strong>Problem:</strong> <code>npm ci</code> deletes node_modules every time (slow)
</div>
<div class="success" style="margin-top: 15px;">
<strong>Solution:</strong> Use <code>npm install</code> for local dev, <code>npm ci</code> for CI!
</div>
</div>
</div>
</div>
<div class="accordion-item">
<div class="accordion-header" onclick="toggleAccordion(this)">
<span><strong>4. Mixing Both Commands</strong></span>
<span class="accordion-icon">▼</span>
</div>
<div class="accordion-content">
<div class="accordion-body">
<div class="warning">
<strong>Problem:</strong> Switching between commands causes confusion
</div>
<div class="success" style="margin-top: 15px;">
<strong>Solution:</strong> Pick one per environment - install for dev, ci for automation!
</div>
</div>
</div>
</div>
</div>
</div>
</section>
<!-- Pro Tips -->
<section class="section">
<h2 class="section-title">🚀 Pro Tips</h2>
<div class="card">
<div class="tip">
<strong>CI/CD golden rule</strong> - ALWAYS use <code>npm ci</code> in automated pipelines!
</div>
<div class="tip">
<strong>Speed boost</strong> - <code>npm ci</code> is up to 2x faster than install in CI!
</div>
<div class="tip">
<strong>Commit lock file</strong> - Always commit package-lock.json for reproducibility!
</div>
<div class="tip">
<strong>Fresh start</strong> - Use <code>npm ci</code> when debugging dependency issues!
</div>
<div class="tip">
<strong>Production deploys</strong> - Use <code>npm ci --production</code> to skip devDependencies!
</div>
<div class="tip">
<strong>Team consistency</strong> - Have team use <code>npm ci</code> for exact same versions!
</div>
<div class="tip">
<strong>Docker optimization</strong> - Use <code>npm ci</code> in Dockerfiles for faster builds!
</div>
</div>
</section>
<!-- Quiz -->
<section class="section">
<h2 class="section-title">🎯 Knowledge Check Quiz</h2>
<div class="quiz-container">
<p style="margin-bottom: 30px; font-size: 1.1rem;">Test your understanding! 🧠</p>
<div class="quiz-question">
<h3>Question 1: Which is faster in CI/CD?</h3>
<div class="quiz-options">
<div class="quiz-option" onclick="checkAnswer(this, false, 1)">A) npm install</div>
<div class="quiz-option" onclick="checkAnswer(this, true, 1)">B) npm ci</div>
<div class="quiz-option" onclick="checkAnswer(this, false, 1)">C) Both are the same</div>
</div>
<div class="quiz-feedback" id="feedback1"></div>
</div>
<div class="quiz-question">
<h3>Question 2: Which updates package-lock.json?</h3>
<div class="quiz-options">
<div class="quiz-option" onclick="checkAnswer(this, true, 2)">A) npm install</div>
<div class="quiz-option" onclick="checkAnswer(this, false, 2)">B) npm ci</div>
<div class="quiz-option" onclick="checkAnswer(this, false, 2)">C) Both do</div>
</div>
<div class="quiz-feedback" id="feedback2"></div>
</div>
<div class="quiz-question">
<h3>Question 3: Best for local development?</h3>
<div class="quiz-options">
<div class="quiz-option" onclick="checkAnswer(this, true, 3)">A) npm install</div>
<div class="quiz-option" onclick="checkAnswer(this, false, 3)">B) npm ci</div>
<div class="quiz-option" onclick="checkAnswer(this, false, 3)">C) Doesn't matter</div>
</div>
<div class="quiz-feedback" id="feedback3"></div>
</div>
<div id="quizScore" style="margin-top: 30px; padding: 20px; background: var(--bg-secondary); border-radius: 12px; display: none;">
<h3 style="color: var(--accent-green); font-size: 1.5rem;">🎉 Quiz Complete!</h3>
<p id="scoreText" style="font-size: 1.2rem; margin-top: 10px;"></p>
</div>
</div>
</section>
<!-- Summary Card -->
<section class="section">
<h2 class="section-title">📚 Quick Reference</h2>
<div class="cheat-sheet">
<h3 style="margin-bottom: 20px; font-size: 2rem;">npm install vs npm ci Cheat Sheet! 🔖</h3>
<div class="cheat-grid">
<div class="cheat-item">
<h4>💻 npm install</h4>
<p><code>npm install</code></p>
<p style="font-size: 0.85rem; margin-top: 5px;">Development, flexible</p>
</div>
<div class="cheat-item">
<h4>🏭 npm ci</h4>
<p><code>npm ci</code></p>
<p style="font-size: 0.85rem; margin-top: 5px;">CI/CD, strict</p>
</div>
<div class="cheat-item">
<h4>📝 Updates Lock</h4>
<p>install: Yes ✅<br>ci: No ❌</p>
<p style="font-size: 0.85rem; margin-top: 5px;">Key difference</p>
</div>
<div class="cheat-item">
<h4>⚡ Speed</h4>
<p>ci is faster!</p>
<p style="font-size: 0.85rem; margin-top: 5px;">Up to 2x in CI</p>
</div>
<div class="cheat-item">
<h4>🗑️ Deletes node_modules</h4>
<p>install: No<br>ci: Yes</p>
<p style="font-size: 0.85rem; margin-top: 5px;">Fresh install</p>
</div>
<div class="cheat-item">
<h4>📦 Requires Lock</h4>
<p>install: No<br>ci: Yes</p>
<p style="font-size: 0.85rem; margin-top: 5px;">Must have lock</p>
</div>
<div class="cheat-item">
<h4>🎯 Use Case</h4>
<p>install: Dev<br>ci: Production</p>
<p style="font-size: 0.85rem; margin-top: 5px;">Choose wisely</p>
</div>
<div class="cheat-item">
<h4>✅ Best Practice</h4>
<p>Dev: install<br>CI: ci</p>
<p style="font-size: 0.85rem; margin-top: 5px;">Golden rule!</p>
</div>
</div>
</div>
</section>
<!-- Footer -->
<div class="footer">
<h2 style="font-size: 2rem; margin-bottom: 20px; color: var(--accent-pink);">🎉 Congratulations!</h2>
<p style="font-size: 1.2rem; margin-bottom: 20px;">You now understand <strong>npm install vs npm ci</strong>! 🚀</p>
<div style="margin: 30px 0;">
<span class="badge">💻 Install Expert</span>
<span class="badge">🏭 CI Master</span>
<span class="badge">🚀 npm Pro</span>
</div>
<p style="color: var(--text-secondary); margin-top: 30px;">Generated by <strong>AI Prompt Dictionary</strong> 🤖</p>
<p style="color: var(--text-secondary); font-size: 0.9rem;">Made with ❤️ for developers learning npm</p>
</div>
</div>
<script>
// Progress bar
window.addEventListener('scroll', () => {
const winScroll = document.body.scrollTop || document.documentElement.scrollTop;
const height = document.documentElement.scrollHeight - document.documentElement.clientHeight;
const scrolled = (winScroll / height) * 100;
document.getElementById('progressBar').style.width = scrolled + '%';
});
// Copy to clipboard
function copyCode(codeId) {
const code = document.getElementById(codeId).innerText;
navigator.clipboard.writeText(code).then(() => {
event.target.textContent = '✅ Copied!';
event.target.classList.add('copied');
setTimeout(() => {
event.target.textContent = '📋 Copy';
event.target.classList.remove('copied');
}, 2000);
});
}
// Tab switching
function switchTab(tabName) {
document.querySelectorAll('.tab-content').forEach(c => c.classList.remove('active'));
document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
document.getElementById(tabName).classList.add('active');
event.target.classList.add('active');
}
// Accordion toggle
function toggleAccordion(header) {
const content = header.nextElementSibling;
const icon = header.querySelector('.accordion-icon');
content.classList.toggle('active');
icon.classList.toggle('active');
}
// Simulate npm install
function simulateInstall() {
const terminal = document.getElementById('terminal');
terminal.innerHTML = '<div class="terminal-line"><span class="terminal-prompt">$</span> npm install</div>';
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-cyan); margin-top: 10px;">📖 Reading package.json...</div>';
terminal.innerHTML += '<div style="color: var(--accent-blue); margin-left: 20px;">✓ Found 15 dependencies</div>';
}, 500);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-yellow); margin-top: 10px;">🔍 Checking package-lock.json...</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">Resolving versions...</div>';
}, 1500);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-blue); margin-top: 10px;">📥 Installing packages...</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">+ express@4.18.2</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">+ lodash@4.17.21</div>';
}, 2500);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-green); margin-top: 10px; font-weight: 600;">✅ Installed 15 packages in 3.2s</div>';
terminal.innerHTML += '<div style="color: var(--accent-yellow); margin-top: 5px;">📝 Updated package-lock.json</div>';
terminal.innerHTML += '<div style="color: var(--accent-cyan); margin-top: 10px;">💡 Flexible - can update versions within semver ranges</div>';
createConfetti();
}, 3800);
}
// Simulate npm ci
function simulateCi() {
const terminal = document.getElementById('terminal');
terminal.innerHTML = '<div class="terminal-line"><span class="terminal-prompt">$</span> npm ci</div>';
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-cyan); margin-top: 10px;">🔍 Checking package-lock.json...</div>';
terminal.innerHTML += '<div style="color: var(--accent-green); margin-left: 20px;">✓ Lock file found</div>';
}, 500);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-red); margin-top: 10px;">🗑️ Removing existing node_modules...</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">Deleted successfully</div>';
}, 1200);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-green); margin-top: 10px;">📥 Installing from lock file...</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">+ express@4.18.2 (exact)</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">+ lodash@4.17.21 (exact)</div>';
}, 2200);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-green); margin-top: 10px; font-weight: 600;">✅ Installed 15 packages in 1.8s</div>';
terminal.innerHTML += '<div style="color: var(--accent-green); margin-top: 5px;">🎯 Exact versions - 100% reproducible!</div>';
terminal.innerHTML += '<div style="color: var(--accent-cyan); margin-top: 5px;">⚡ Faster than npm install</div>';
terminal.innerHTML += '<div style="color: var(--accent-purple); margin-top: 10px;">🏭 Perfect for CI/CD!</div>';
createConfetti();
}, 3500);
}
// Simulate comparison
function simulateComparison() {
const terminal = document.getElementById('terminal');
terminal.innerHTML = '<div style="color: var(--accent-purple); font-weight: 600; font-size: 1.1rem;">⚔️ Comparing npm install vs npm ci...</div>';
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-blue); margin-top: 20px; font-weight: 600;">💻 npm install:</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Flexible version resolution</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Updates package-lock.json</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Works without lock file</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Best for development</div>';
}, 1000);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-green); margin-top: 20px; font-weight: 600;">🏭 npm ci:</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Exact version installation</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Never modifies lock file</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Requires lock file</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Deletes node_modules first</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Faster (up to 2x)</div>';
terminal.innerHTML += '<div style="color: var(--text-secondary); margin-left: 20px;">✓ Best for CI/CD</div>';
}, 2500);
setTimeout(() => {
terminal.innerHTML += '<div style="color: var(--accent-yellow); margin-top: 20px; font-weight: 600;">🎯 Golden Rule:</div>';
terminal.innerHTML += '<div style="color: var(--accent-blue); margin-left: 20px;">Development → npm install</div>';
terminal.innerHTML += '<div style="color: var(--accent-green); margin-left: 20px;">CI/CD & Production → npm ci</div>';
terminal.innerHTML += '<div style="color: var(--accent-purple); margin-top: 15px; font-weight: 600; font-size: 1.1rem;">✨ Use the right tool for the job!</div>';
createConfetti();
}, 4000);
}
// Quiz system
let quizScore = 0;
let questionsAnswered = 0;
function checkAnswer(element, isCorrect, questionNum) {
const options = element.parentElement.querySelectorAll('.quiz-option');
options.forEach(opt => opt.style.pointerEvents = 'none');
const feedback = document.getElementById('feedback' + questionNum);
if (isCorrect) {
element.classList.add('correct');
feedback.className = 'quiz-feedback correct show';
feedback.innerHTML = '<strong>🎉 Correct!</strong> Great job!';
quizScore++;
createConfetti();
} else {
element.classList.add('incorrect');
feedback.className = 'quiz-feedback incorrect show';
feedback.innerHTML = '<strong>❌ Not quite!</strong> Review the material and try again!';
}
questionsAnswered++;
if (questionsAnswered === 3) {
setTimeout(() => {
document.getElementById('quizScore').style.display = 'block';
document.getElementById('scoreText').textContent = `You scored ${quizScore}/3! ${quizScore === 3 ? '🏆 Perfect!' : quizScore === 2 ? '👍 Good job!' : '💪 Keep learning!'}`;
}, 1000);
}
}
// Confetti animation
function createConfetti() {
const colors = ['#3b82f6', '#10b981', '#a855f7', '#f59e0b', '#ec4899'];
for (let i = 0; i < 50; i++) {
const confetti = document.createElement('div');
confetti.className = 'confetti';
confetti.style.left = Math.random() * window.innerWidth + 'px';
confetti.style.background = colors[Math.floor(Math.random() * colors.length)];
confetti.style.animationDuration
Live Preview