Skip to content

JavaScriptSolidServer/fastpod

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

fastpod

The fastest way to run a Solid pod. Zero configuration, just works.

npm version License

fastpod is the quickest way to get your own Solid pod server running.

๐Ÿš€ Quick Start

# Run instantly with npx (no installation required!)
npx fastpod

# That's it! Your Solid pod is running at http://localhost:5444

โšก Performance

fastpod lives up to its name. Here are real benchmark results:

๐Ÿ Benchmark Results
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
  Startup Time:        ~3 seconds
  First Response:      3ms

  Average Response Times:
    GET:     0.63ms
    PUT:     0.84ms
    POST:    0.64ms
    DELETE:  0.44ms

  Throughput:          1,569 requests/sec
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

What this means:

  • ๐Ÿš€ Server starts in ~3 seconds from npx fastpod
  • โšก Sub-millisecond response times for all operations
  • ๐Ÿ’ช Handles 1,500+ requests per second
  • ๐ŸŽฏ Production-ready performance out of the box

โœจ Features

  • โœ… Zero configuration - Just works
  • โœ… Lightning fast - Server starts in seconds
  • โœ… Solid Protocol - Full spec compliance
  • โœ… WebID Authentication - Decentralized identity
  • โœ… Passkey Support - Modern passwordless auth
  • โœ… WebSocket Notifications - Real-time updates
  • โœ… JSON-LD Native - First-class linked data support

๐Ÿ“ฆ Installation

No Installation (Recommended)

npx fastpod

Global Installation

npm install -g fastpod
fastpod

๐ŸŽฎ Usage

# Start with defaults
fastpod

# Custom port
fastpod --port 8080

# Custom data directory
fastpod --root /var/pods

# Multi-user mode
fastpod --multiuser

# Disable authentication
fastpod --no-auth

# Show help
fastpod --help

๐Ÿ“– How It Works

fastpod is a lightweight wrapper around jspod, which provides a beautiful CLI for JavaScriptSolidServer.

Stack:

fastpod โ†’ jspod โ†’ JavaScriptSolidServer

Each layer adds value:

  • JavaScriptSolidServer: Full-featured Solid server implementation
  • jspod: Beautiful CLI with sensible defaults
  • fastpod: Fastest, easiest way to get started

๐ŸŒŸ First Run

Step 1: Run the command

npx fastpod

Step 2: Open http://localhost:5444 in your browser

Step 3: Register with your device's passkey (fingerprint, Face ID, etc.)

Step 4: Start using your pod!

๐ŸŽฏ Why fastpod?

  • Fast to type: Just 7 characters (fastpod)
  • Fast to start: Server ready in 3 seconds
  • Fast to respond: Sub-millisecond response times (0.44-0.84ms)
  • Fast to scale: 1,500+ requests/second throughput
  • Fast to learn: Zero configuration needed
  • Fast to deploy: One command and you're live

๐Ÿ“š Learn More

๐Ÿค Contributing

Contributions welcome! This package is intentionally minimal - just a friendly wrapper.

๐Ÿ“„ License

MIT - see LICENSE

๐Ÿ™ Credits

Built on jspod and JavaScriptSolidServer.


Made with โค๏ธ for the Solid community

"Your pod, fast"

About

Fast Solid Pod - The fastest way to run a Solid pod

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors