Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hugorcd/shelve

All-in-one development workspace for managing environments and collaborating on projects.
https://github.com/hugorcd/shelve

cli env environment-variables monorepo nuxt project-management secrets-management typescript variables vercel

Last synced: 3 days ago
JSON representation

All-in-one development workspace for managing environments and collaborating on projects.

Host: GitHub
URL: https://github.com/hugorcd/shelve
Owner: HugoRCD
License: apache-2.0
Created: 2024-02-27T13:51:42.000Z (10 months ago)
Default Branch: main
Last Pushed: 2024-12-18T08:04:22.000Z (7 days ago)
Last Synced: 2024-12-18T19:51:18.549Z (7 days ago)
Topics: cli, env, environment-variables, monorepo, nuxt, project-management, secrets-management, typescript, variables, vercel
Language: Vue
Homepage: https://shelve.cloud
Size: 14.4 MB
Stars: 105
Watchers: 3
Forks: 3
Open Issues: 26
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/funding.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

        


  

# Shelve

### The all-in-one development workspace

[![npm version](https://img.shields.io/npm/v/@shelve/cli?color=black)](https://npmjs.com/package/@shelve/cli)

[![npm downloads](https://img.shields.io/npm/dm/@shelve/cli?color=black)](https://npm.chart.dev/@shelve/cli)

[![license](https://img.shields.io/github/license/HugoRCD/shelve?color=black)](https://github.com/HugoRCD/shelve/blob/main/LICENSE)

[Website](https://shelve.cloud) • [Documentation](https://shelve.cloud/docs)



---

## 📑 Table of Contents

Click to expand

- [📋 Overview](#-overview)

  - [🎯 Vision & Goals](#vision--goals)

  - [🗺️ Status & Roadmap](#status--roadmap)

- [✨ Features](#-features)

  - [🔑 Core Features](#core-features)

  - [🤔 Why Choose Shelve?](#why-choose-shelve)

- [🛠️ Tech Stack](#-tech-stack)

- [🤝 Contributing](#-contributing)

- [📚 Documentation](#-documentation)

  - [📖 Full Documentation](#full-documentation)

  - [🏠 Self-Hosting](#self-hosting)

- [💬 Community & Support](#-community--support)

  - [🔗 Community Links](#community-links)

  - [❓ Where to Ask Questions](#where-to-ask-questions)

  - [🐛 How to Report Bugs](#how-to-report-bugs)

  - [💡 How to Suggest Features](#how-to-suggest-features)

- [📄 License & Credits](#license--credits)

  - [🙏 Acknowledgements](#acknowledgements)

## 📋 Overview

> 💡 **Shelve** is an all-in-one development workspace that revolutionizes how developers manage environments and collaborate on projects.

### Vision & Goals

Shelve aims to become the ultimate development workspace by addressing common pain points in modern development workflows:

- 🎯 **Simplify** environment management

- 🤝 **Enhance** team collaboration

- 🚀 **Accelerate** development setup

- 🔒 **Secure** sensitive data

### Status & Roadmap

  

    🏗️ Current Status

    Active Development

  

  

    📅 Next Release

    v2.0.0 (Q4 2024)

  

#### Upcoming Features

- 🔄 Ecosystem management for multi-repository synchronization (e.g., [UnJs](https://unjs.io))

- 🔌 Enhanced integrations (GitHub, Vercel, Coolify) (e.g., environment variable syncing)

- ⚡️ Automatic project setup with GitHub and Vercel (auto-repo creation, auto-deployment)

- 🎨 Major UI improvements for a seamless experience (become one of the most beautiful dev tools)

## ✨ Features

### Core Features

- 🔐 **Environment Management**

  - Secure variable sharing

  - Vault system for sharing secrets

  - Multi-environment support

  - Custom environment support

  - Auto-formatting and validation

  - Secure value generator

  - Drag-and-drop .env file import

- 🛠️ **Developer Experience**

  - CLI-first approach

  - Zero configuration setup

  - Automatic project detection

  - Secure value generator

  - Modern and intuitive interface

- 👥 **Team Collaboration**

  - Team workspaces

  - Role-based access control

- 🚀 **Deployment & Integration**

  - GitHub integration

  - One-click deploy with Coolify

  - Self-hostable with Docker support

  - OAuth authentication

- 🔒 **Security First**

  - End-to-end encryption

  - OAuth authentication

  - Role-based access control

### Why Choose Shelve?

- **All-in-One**: Shelve is not only an environment manager but also a project complete workspace for creating and managing projects.

- **Free and Open-Source**: Shelve is free to use and open-source, making it accessible to all developers. No more 20$ per month for a simple environment manager feature like some competitors (*cough* Vercel *cough*).

- **Secure and Private**: Shelve provides end-to-end encryption and secure sharing, ensuring the safety of your data.

- **Easter Eggs**: Shelve is full of surprises, the more you use it, the more you discover hidden features.

- **Community-Driven**: Shelve is built by developers, for developers, with a strong focus on community feedback and contributions.

## 🛠️ Tech Stack

- **Frontend**: Nuxt, Tailwind CSS

- **Backend**: Nitro, Bun

- **Infrastructure**: Turborepo, Docker

- **Database**: DrizzleORM, PostgreSQL

- **Mailer**: Resend

- **Validation**: Zod

- **CI/CD**: GitHub Actions

## 🤝 Contributing

For more detailed about contributing, please refer to the [Contributing Guide](CONTRIBUTING.md).

## 📚 Documentation

### Full Documentation

For comprehensive documentation, visit the [Shelve Documentation](https://shelve.cloud/docs).

### Self-Hosting

To self-host the Shelve application, refer to the [Self-Hosting Section](./docker/README.md).

## 💬 Community & Support

### Community Links

- [GitHub Issues](https://github.com/HugoRCD/shelve/issues)

### Where to Ask Questions

For questions and support, join our [Discord Community](https://discord.gg/shelve) or open an issue on GitHub.

### How to Report Bugs

To report bugs, open an issue on the [GitHub Issues](https://github.com/HugoRCD/shelve/issues) page.

### How to Suggest Features

To suggest new features, open an issue on the [GitHub Issues](https://github.com/HugoRCD/shelve/issues) page.

## License & Credits

### Acknowledgements

We would like to thank all contributors and the open-source community for their support.

Published under the [APACHE](https://github.com/HugoRCD/shelve/blob/main/LICENSE) license.

Made by [@HugoRCD](https://github.com/HugoRCD), [@CavallucciJohann](https://github.com/CavallucciJohann) and [community](https://github.com/HugoRCD/shelve/graphs/contributors) 💛











---

_🤖 auto updated with [automd](https://automd.unjs.io) (last updated: Wed Nov 27 2024)_