pinme
This skill should be used when the user asks to "deploy", "upload", "publish", or "pin" any files, folders, frontend projects, or static websites to IPFS. Also activates when user mentions "pinme", "IPFS", or wants to share files via decentralized storage.
When & Why to Use This Skill
The PinMe Claude skill streamlines the process of deploying and hosting content on IPFS (InterPlanetary File System). It automates the workflow for uploading files, folders, and modern frontend projects (like React, Vue, and Next.js) to decentralized storage. By integrating PinMe CLI commands, it provides users with instant preview URLs and ensures content persistence through decentralized pinning, making it an essential tool for Web3 developers and users seeking censorship-resistant hosting.
Use Cases
- Decentralized Website Deployment: Automatically detect build folders (dist, build, out) and deploy static sites to IPFS after a build process.
- Secure File Sharing: Upload documents, images, or archives to decentralized storage and generate shareable preview links.
- Web3 Development Workflow: Simplify the 'build-and-publish' cycle for decentralized applications (dApps) directly within the chat interface.
- Content Pinning: Ensure long-term data availability on the IPFS network by pinning specific files or directories using the PinMe service.
| name | glitternetwork |
|---|---|
| version | 1.0.0 |
| description | This skill should be used when the user asks to "deploy", "upload", "publish", or "pin" any files, folders, frontend projects, or static websites to IPFS. Also activates when user mentions "pinme", "IPFS", or wants to share files via decentralized storage. |
| url | https://github.com/glitternetwork |
| homepage | https://github.com/glitternetwork/skills/tree/main/pinme |
| repository | https://github.com/glitternetwork/skills |
| license | MIT |
PinMe Skill
Use PinMe CLI to upload files to IPFS and get a preview URL.
When to Use
General File Upload
- User wants to upload any files or folders to IPFS
- User wants to share files via decentralized storage
- User mentions "pinme", "pin", "IPFS", or "upload to IPFS"
Website Deployment
- User requests deployment of a frontend project
- User wants to deploy a static website
- After building a frontend project (Vue, React, Next.js, etc.)
Upload Steps
1. Check if PinMe is Installed
pinme --version
If not installed:
npm install -g pinme
2. Identify Upload Target
For general files:
- Use the file or directory path specified by the user
- Can be any file type: images, documents, archives, etc.
For website deployment: Look for build output directories (in priority order):
dist/- Vue/React/Vite default outputbuild/- Create React App outputout/- Next.js static exportpublic/- Pure static projects
3. Execute Upload
pinme upload <path>
Examples:
# Upload a single file
pinme upload ./document.pdf
# Upload a folder
pinme upload ./my-folder
# Upload website build output
pinme upload dist
4. Return Result
After successful upload, return the preview URL:
https://pinme.eth.limo/#/preview/<hash>
Users can visit the preview page to:
- View or download the uploaded files
- Get a fixed domain:
https://<name>.pinit.eth.limo
Important Rules
DO:
- Verify the file or directory exists before uploading
- Return the preview URL to the user
DO NOT:
- Upload
node_modules/ - Upload
.envfiles - Upload
.git/directory - Upload empty or non-existent paths
For website deployment, also avoid:
- Uploading source code instead of build output
- Uploading configuration files (package.json, tsconfig.json, etc.)
Common Workflows
General File Upload
# Upload a single file
pinme upload ./image.png
# Upload a folder
pinme upload ./my-documents
# Upload with specific path
pinme upload /path/to/files
Website Deployment
Vue/Vite
npm run build
pinme upload dist
React CRA
npm run build
pinme upload build
Next.js Static
npm run build
npm run export # or next export
pinme upload out
Error Handling
| Error | Solution |
|---|---|
command not found: pinme |
Run npm install -g pinme |
No such file or directory |
Check path exists |
Permission denied |
Check file/folder permissions |
| Upload failed | Check network, retry |
Other Commands
# List upload history
pinme list
pinme ls -l 5
# Remove uploaded file
pinme rm <hash>