feat: initial release of solidpod v0.0.1

Solidpod is a simple, user-friendly wrapper around jspod for running Solid pod servers.

Features:
- Zero configuration - run with npx solidpod
- Thin wrapper around jspod
- Clear, memorable name for easy discovery
- Passes all arguments through to jspod
- Simple signal forwarding

Author: melvincarvalho

.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+pod-data/
+*.log
+.DS_Store
+.env

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.

README.md

@@ -0,0 +1,114 @@
+# solidpod
+
+> The easiest way to run a Solid pod. Zero configuration, just works.
+
+[![npm version](https://img.shields.io/npm/v/solidpod.svg)](https://www.npmjs.com/package/solidpod)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**solidpod** is the simplest wrapper to run your own [Solid](https://solidproject.org) pod server.
+
+## 🚀 Quick Start
+
+```bash
+# Run instantly with npx (no installation required!)
+npx solidpod
+
+# That's it! Your Solid pod is running at http://localhost:5444
+```
+
+## ✨ What You Get
+
+- ✅ **Zero configuration** - Just works
+- ✅ **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 solidpod
+```
+
+### Global Installation
+
+```bash
+npm install -g solidpod
+solidpod
+```
+
+## 🎮 Usage
+
+```bash
+# Start with defaults
+solidpod
+
+# Custom port
+solidpod --port 8080
+
+# Custom data directory
+solidpod --root /var/pods
+
+# Multi-user mode
+solidpod --multiuser
+
+# Disable authentication
+solidpod --no-auth
+
+# Show help
+solidpod --help
+```
+
+## 📖 How It Works
+
+solidpod is a thin wrapper around [jspod](https://github.com/JavaScriptSolidServer/jspod), which itself wraps [JavaScriptSolidServer](https://github.com/JavaScriptSolidServer/JavaScriptSolidServer).
+
+**Layers:**
+```
+solidpod → jspod → JavaScriptSolidServer
+```
+
+Each layer adds convenience:
+- **JavaScriptSolidServer**: Full-featured Solid server implementation
+- **jspod**: Beautiful CLI with sensible defaults
+- **solidpod**: Most user-friendly name for instant discovery
+
+## 🌟 First Run
+
+**Step 1**: Run the command
+```bash
+npx solidpod
+```
+
+**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!
+
+## 📚 Learn More
+
+- **Solid Project**: https://solidproject.org
+- **Solid Protocol**: https://solidproject.org/TR/protocol
+- **WebID**: https://www.w3.org/2005/Incubator/webid/spec
+
+## 🤝 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, instantly"*

index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+/**
+ * solidpod - Solid Pod Server
+ * The easiest 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.json

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