---

📑 Table of Contents

Click to expand

• 📋 Overview
  • 🎯 The Vision
  • 🗺️ Status & Roadmap
• ✨ Key Features
  • 🔒 Secure Secrets Management
  • 💻 Developer Experience (DX)
  • 🔄 Sync & Integrations
  • 👥 Team Collaboration
• 🤔 Why Shelve?
• 🛠️ Tech Stack
• 🤝 Contributing
• 📚 Documentation
  • 📖 Full Documentation
  • 🏠 Self-Hosting
• 💬 Community & Support
• 📄 License & Credits

📋 Overview

Shelve provides the secure foundation for effortless secrets management. Stop juggling .env files and scattered keys. Bring clarity, security, and synchronization to your application configurations.

Shelve tackles the common frustrations of managing environment variables and secrets in modern development: the security risks, the collaboration friction, and the time wasted on manual processes. We provide a centralized, secure, and intuitive platform designed from the ground up with developer experience as the priority.

🎯 The Vision

While Shelve excels at secrets management today, our vision extends further. We are building towards a unified developer workspace – a central hub designed to streamline critical development workflows, eliminate friction, and integrate seamlessly with the tools you already use. Secrets management is the cornerstone, but the goal is broader productivity and flow.

🗺️ Status & Roadmap

Upcoming Focus

• 🔄 Multi-Repo Config Sync: Manage configuration files (dotfiles, CI templates) across multiple repositories.
• 🔌 Enhanced Integrations: Deeper connections with platforms like Vercel, Netlify, etc.
• ⚡️ Workflow Automation: Streamlining project setup and deployment processes.

✨ Key Features

🔒 Secure Secrets Management

• Centralized Vault: Securely store API keys, tokens, variables in one organized dashboard.
• Encryption: Secrets hashed (SHA-256) and encrypted (AES-256) at rest.
• Environment Parity: Easily manage configurations across dev, staging, prod, and custom environments.
• Secure Sharing: Built-in Vault for time-limited, secure secret sharing.
• Validation & Formatting: Ensure consistency and prevent errors.

💻 Developer Experience (DX)

• Command Palette (Cmd+K): Instantly search, navigate, and execute actions.
• Powerful CLI (@shelve/cli): Fetch, push, and inject secrets (shelve run) directly from your terminal.
• Intuitive UI: Clean, modern, and efficient interface built with Nuxt UI.
• Zero Config: Automatic project detection and sensible defaults.

🔄 Sync & Integrations

• GitHub Sync: Automatically sync secrets with GitHub Actions & Repository secrets via the official GitHub App.
• CLI Sync: shelve pull and shelve push for seamless terminal workflows.
• API Access: (If applicable) Programmatic access for custom integrations.

👥 Team Collaboration

• Workspaces: Organize projects and secrets for teams.
• Role-Based Access Control: Simple and effective permissions (Owner, Admin, Member).
• Seamless Sync: Ensure everyone has the right configuration at the right time.

🤔 Why Shelve?

• Effortless & Secure: Provides a robust, reliable foundation for managing your most sensitive configurations without the usual complexity.
• Exceptional DX: Designed by developers, for developers, focusing on speed, intuition, and reducing friction (CLI, Cmd+K, clean UI).
• Open Source & Accessible: Completely free to use, transparent development, and driven by the community. No feature paywalls for core functionality.
• Flexible & Integrated: Offers seamless GitHub integration, a powerful CLI, and self-hosting options (Docker, Coolify) for full control.

🛠️ Tech Stack

• Framework: Nuxt
• UI: Nuxt UI, Tailwind CSS
• Server: Nitro
• Database: PostgreSQL, DrizzleORM
• Monorepo: Turborepo
• Deployment: Vercel
• Mailer: Resend
• Validation: Zod
• CI/CD: GitHub Actions

🤝 Contributing

We thrive on community contributions! Whether it's code, documentation, bug reports, or feature ideas, we welcome your help. Please see our Contributing Guide to get started.

📚 Documentation

Full Documentation

For comprehensive guides, API references, and setup instructions, visit the Shelve Documentation.

Self-Hosting

Want full control? Deploy Shelve on your own Vercel account using Vercel.

💬 Community & Support

• Issues & Feature Requests: GitHub Issues (Best for bugs & feature tracking)
• Questions & Discussion: (Consider adding GitHub Discussions if enabled, or Discord/Slack if you have one)
• Direct Contact: contact@shelve.cloud

📄 License & Credits

Published under the APACHE-2.0 license.

Acknowledgements

A huge thank you to all contributors, sponsors, and the incredible open-source community that makes projects like Shelve possible.

Sponsors

Made with 💛 by @HugoRCD and community.

---

🤖 auto updated with automd (last updated: Sat Apr 12 2025)