# Clone the repository
git clone https://github.com/1990webarchive/1990-web-archive.git
cd 1990-web-archive

# Install dependencies
npm install

# Configure environment variables
cp .env.example .env
# Edit .env with your configuration

# Run database migrations
npm run migrate

# Start the development server
npm run dev

# Pull and run with Docker Compose
docker compose up -d

# Verify the service is running
curl http://localhost:3000/api/health

import { ArchiveClient } from '@1990web/archive-sdk';

const archive = new ArchiveClient({
  apiKey: process.env.ARCHIVE_API_KEY,
  baseURL: 'https://api.1990web.archive/v2',
});

// Search for pages from 1995
const pages = await archive.search({
  era: '1995',
  maxResults: 50,
  sortBy: 'relevance',
});

// Render a preserved page
const rendered = await archive.render(pages[0].id);
console.log(rendered.html);
console.log(rendered.timestamp); // '1995-03-14T08:30:00Z'

# ┌────────────────────────────────────────────────────┐
# │                  Client / SDK                      │
# └──────────────────────┬─────────────────────────────┘
#                        ▼
# ┌────────────────────────────────────────────────────┐
# │              API Gateway (Rust)                    │
# │  ┌──────────┐  ┌───────────┐  ┌────────────────┐ │
# │  │   REST   │  │  GraphQL  │  │  WebSocket     │ │
# │  └────┬─────┘  └─────┬─────┘  └───────┬────────┘ │
# └───────┼──────────────┼────────────────┼───────────┘
#         ▼              ▼                ▼
#   ┌─────────┐   ┌──────────┐    ┌───────────┐
#   │ Search  │   │ Render   │    │Provenance │
#   │ Engine  │   │ Engine   │    │ Service   │
#   └────┬────┘   └────┬─────┘    └─────┬─────┘
#        ▼              ▼                ▼
#   ┌─────────────────────────────────────────────┐
#   │           Distributed Storage               │
#   │       (Deduplicated Blobs + Indexes)        │
#   └─────────────────────────────────────────────┘
#                                                    │
#         ┌──────────────────────────────────────────┘
#         ▼
#   ┌─────────────────────────────────────────────┐
#   │           Archive Nodes (Crawlers)           │
#   │  (Emulating Netscape, IE, Mosaic, etc.)     │
#   └─────────────────────────────────────────────┘
# ──────────────────────────────────────────────────

BASE_URL = https://api.1990web.archive/v2

{
  "query": "web ring guestbook",
  "filters": {
    "era": "1990-1999",
    "technology": ["frameset", "gif"],
    "siteType": "personal"
  },
  "sortBy": "relevance",
  "page": 1,
  "perPage": 20
}

{
  "ok": true,
  "total": 42187,
  "page": 1,
  "perPage": 20,
  "results": [
    {
      "id": "gct:geocities:8832:index.html",
      "url": "http://geocities.com/Area51/Cavern/8832/",
      "snapshotDate": "1997-06-12T00:00:00Z",
      "title": "★ Cool Web Page ★
        - Under Construction",
      "technologies": ["frameset", "animated-gif",
                        "marquee", "guestbook"],
      "provenance": "sha256:a8f5f167f44f4964..."
    }
  ]
}

# Search for pages from the 1990s
1990archive search "web ring" --era 1990s --limit 10

# View details of a specific archived page
1990archive show "gct:geocities:8832:index.html"

# Render a page in a simulated browser
1990archive render "gct:geocities:8832:index.html" --browser "netscape3"

# Download all pages from a specific GeoCities area
1990archive download "gct:Area51/*" --output "./archive/area51"

# Generate a report on technology adoption
1990archive stats --era 1990s --output "report.pdf"

import { CollectionBuilder } from '@1990web/archive-sdk';

// Build a collection of GeoCities pages from 1996
const builder = new CollectionBuilder({
  name: 'Geocities Golden Era',
  description: 'Best of 1996 GeoCities personal pages',
});

builder
  .filter({ era: '1996', siteType: 'personal' })
  .filter({ technologies: ['animated-gif', 'marquee'] })
  .sortBy('popularity')
  .limit(100);

// Export as HTML (authentic 90s style!) or JSON
await builder.export('geo-golden-era', 'html');
console.log(`Exported ${builder.count} pages`); 
// → Exported 100 pages

1990-web-archive/
├── # Core Services
│   ├── archiver/          # Distributed crawler
│   │   ├── src/
│   │   ├── protocols/     # HTTP, FTP, Gopher handlers
│   │   └── renderers/    # Browser emulators
│   │
│   ├── renderer/          # Pixel-perfect rendering engine
│   │   ├── src/
│   │   ├── wasm/          # WebAssembly modules
│   │   └── fonts/         # Period-appropriate fonts
│   │
│   ├── search-engine/     # Go-based search index
│   ├── storage/           # Distributed blob storage
│   ├── api-gateway/       # REST + GraphQL gateway
│   └── provenance/        # Cryptographic signing
│
├── packages/              # SDK & Libraries
│   ├── archive-sdk/       # TypeScript SDK
│   ├── cli/               # Command-line interface
│   └── react-components/  # React archive viewer
│
├── docs/                  # Documentation
│   ├── getting-started.md
│   ├── api-reference/
│   └── contributing.md
│
├── test-data/             # Test fixtures & samples
├── .github/               # CI/CD workflows
├── docker-compose.yml
├── package.json
├── tsconfig.json
├── .env.example
└── README.md