Quickstart

Get up and running with Smippo in under 5 minutes. This guide walks you through capturing your first website and viewing it offline.

Before you begin, make sure you have Node.js 18+ installed. You can verify with node --version.

Install Smippo

Install Smippo globally using npm:

npm install -g smippo

Or use it without installing via npx:

npx smippo https://example.com

View all installation options

Capture Your First Page

Let's capture a simple website:

smippo https://example.com

This will:

Launch a browser in the background
Navigate to the URL
Wait for the page to fully render
Capture all resources (HTML, CSS, JS, images, fonts)
Save everything to a ./site directory

You'll see output like:

  Smippo - Modern Website Copier

✓ Capture complete!

  Summary:
    Pages captured:  1
    Assets saved:    12
    Total size:      45.2 KB
    Duration:        2.3s

  Output: ./site

View the Captured Site

Serve the captured site locally:

smippo serve ./site --open

This starts a local web server and opens your browser to view the offline copy. The server provides:

Proper MIME types for all file types
Directory browsing
CORS support

Mirror an Entire Site

Capture multiple pages by specifying a depth:

smippo https://example.com --depth 3

This follows links up to 3 levels deep, capturing all pages and their resources.

Control What Gets Captured

Stay on the same domain:

smippo https://example.com --depth 3 --scope domain

Include external assets (CDNs, fonts):

smippo https://example.com --depth 3 --external-assets

Strip JavaScript for true offline viewing:

smippo https://example.com --depth 3 --static

Use Interactive Mode

Don't remember all the options? Just run:

smippo

This launches an interactive wizard that guides you through all options with sensible defaults.

Take a Quick Screenshot

Need just a screenshot, not a full capture?

# Basic screenshot
smippo capture https://example.com

# Full-page screenshot
smippo capture https://example.com --full-page

# Mobile device screenshot
smippo capture https://example.com --device "iPhone 13"

What's Next?

Now that you've captured your first website, explore more features:

Capture Command — All capture options explained
Filtering — Control what gets captured
Scope Control — Control which links to follow
Examples — Real-world capture scenarios