fastpod 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Melvin Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# fastpod
+
+> The fastest way to run a Solid pod. Zero configuration, just works.
+
+[![npm version](https://img.shields.io/npm/v/fastpod.svg)](https://www.npmjs.com/package/fastpod)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**fastpod** is the quickest way to get your own [Solid](https://solidproject.org) pod server running.
+
+## 🚀 Quick Start
+
+```bash
+# Run instantly with npx (no installation required!)
+npx fastpod
+
+# That's it! Your Solid pod is running at http://localhost:5444
+```
+
+## ⚡ 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)
+
+```bash
+npx fastpod
+```
+
+### Global Installation
+
+```bash
+npm install -g fastpod
+fastpod
+```
+
+## 🎮 Usage
+
+```bash
+# 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](https://github.com/JavaScriptSolidServer/jspod), which provides a beautiful CLI for [JavaScriptSolidServer](https://github.com/JavaScriptSolidServer/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
+```bash
+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
+- **Fast to start**: Server running in seconds
+- **Fast to learn**: Zero configuration needed
+- **Fast to deploy**: One command and you're live
+
+## 📚 Learn More
+
+- **Solid Project**: https://solidproject.org
+- **Solid Protocol**: https://solidproject.org/TR/protocol
+- **WebID**: https://www.w3.org/2005/Incubator/webid/spec
+- **jspod**: https://github.com/JavaScriptSolidServer/jspod
+
+## 🤝 Contributing
+
+Contributions welcome! This package is intentionally minimal - just a friendly wrapper.
+
+## 📄 License
+
+MIT - see [LICENSE](./LICENSE)
+
+## 🙏 Credits
+
+Built on [jspod](https://github.com/JavaScriptSolidServer/jspod) and [JavaScriptSolidServer](https://github.com/JavaScriptSolidServer/JavaScriptSolidServer).
+
+---
+
+**Made with ❤️ for the Solid community**
+
+*"Your pod, fast"*

package/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+/**
+ * fastpod - Fast Solid Pod
+ * The fastest way to run a Solid pod
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join, delimiter } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Pass all arguments through to jspod
+const args = process.argv.slice(2);
+
+// Start jspod with enhanced PATH
+const jspod = spawn('jspod', args, {
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    PATH: `${join(__dirname, 'node_modules', '.bin')}${delimiter}${process.env.PATH}`
+  }
+});
+
+jspod.on('error', (error) => {
+  console.error('Failed to start Solid pod server');
+  console.error(error.message);
+  process.exit(1);
+});
+
+jspod.on('exit', (code) => {
+  process.exit(code);
+});
+
+// Forward signals
+process.on('SIGINT', () => {
+  jspod.kill('SIGTERM');
+});
+
+process.on('SIGTERM', () => {
+  jspod.kill('SIGTERM');
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "fastpod",
+  "version": "0.0.1",
+  "description": "Fast Solid Pod - The fastest way to run a Solid pod",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "fastpod": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JavaScriptSolidServer/fastpod.git"
+  },
+  "keywords": [
+    "solid",
+    "pod",
+    "server",
+    "fast",
+    "linked-data",
+    "webid",
+    "semantic-web",
+    "decentralized",
+    "rdf",
+    "ldp"
+  ],
+  "author": "Melvin Carvalho",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/JavaScriptSolidServer/fastpod/issues"
+  },
+  "homepage": "https://github.com/JavaScriptSolidServer/fastpod#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "jspod": "^0.0.3"
+  }
+}