envilder 0.7.0 → 0.7.1

package/README.md

@@ -70,7 +70,6 @@ onboarding and CI/CD workflows.
   - [✅ How Envilder makes life easier](#-how-envilder-makes-life-easier)
   - [📚 Table of Contents](#-table-of-contents)
   - [⚙️ Features](#️-features)
-    - [🧱 Feature Status](#-feature-status)
   - [💾 Installation](#-installation)
   - [🚀 Quick Start](#-quick-start)
     - [🎥 Video Demonstration](#-video-demonstration)
@@ -94,17 +93,9 @@ onboarding and CI/CD workflows.
 
 ### 🧱 Feature Status
 
-| Feature | Status | Notes |
-|--|--|--|
-| Mapping-based resolution | ✅ Implemented | |
-| `.env` file generation | ✅ Implemented | |
-| AWS profile support | ✅ Implemented | `--profile` flag |
-| Import/push mode (`--push`) | ✅ Implemented | |
-| Auto-discovery (`--auto`) | ❌ Planned | Detect keys based on env |
-| Check/sync mode (`--check`) | ❌ Planned | Diff local vs remote |
-| Webhook/Slack notification | ❌ Planned | On push/pull events |
-| Hierarchical mapping | ❌ Not yet | Flat mapping only |
-| Plugin system | ❌ Not yet | SSM is the only backend (for now) |
+- 🤖 **GitHub Action** — [Integrate directly in CI/CD workflows](./github-action/README.md)
+- 📤 **Push & Pull** — Bidirectional sync between local `.env` and AWS SSM
+- 🎯 **AWS Profile support** — Use `--profile` flag for multi-account setups
 
 ---
 
@@ -126,6 +117,26 @@ pnpm add -g envilder
 > - [Setting up AWS CLI credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
 > - [IAM permissions for SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-profile.html)
 
+### 🤖 GitHub Action
+
+Use Envilder directly in your CI/CD workflows with our official GitHub Action:
+
+```yaml
+- name: Configure AWS Credentials
+  uses: aws-actions/configure-aws-credentials@v5
+  with:
+    role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
+    aws-region: us-east-1
+
+- name: Pull secrets from AWS SSM
+  uses: macalbert/envilder/github-action@v1
+  with:
+    map-file: param-map.json
+    env-file: .env
+```
+
+📖 **[View full GitHub Action documentation](./github-action/README.md)**
+
 ---
 
 ## 🚀 Quick Start
@@ -220,14 +231,13 @@ A: Yes, licensed under MIT.
 
 ## 🏁 Roadmap
 
-🧭 Planned features:
+We're continuously improving Envilder based on community feedback. Upcoming features include:
 
-- 🔍 Drift detection (`--check`)
-- 🧠 Auto-discovery (`--auto`)
-- 📨 Slack/Webhook notifications
-- 🔌 Plugin system (Vault, Secrets Manager, etc.)
+- 🔌 **Multi-backend support** (Azure Key Vault, HashiCorp Vault, etc.)
+- 🔍 **Check/sync mode** for drift detection
+- 🧠 **Auto-discovery** for bulk parameter fetching
 
-👉 See full [ROADMAP.md](./ROADMAP.md)
+👉 **[View full roadmap with priorities](./ROADMAP.md)**
 
 ---
 

package/ROADMAP.md

@@ -3,65 +3,38 @@
 Envilder aims to be the simplest, most reliable way to generate `.env` files from AWS SSM Parameter Store
 — for both local development and CI/CD pipelines.
 
-## ✅ Current Features
-
-- Map-based secret resolution via `param-map.json`
-- Outputs clean `.env` files
-- Supports AWS profiles (`AWS_PROFILE`)
-- Compatible with SecureString and plain parameters
-- CLI-first, lightweight
-- 📸 **Demo GIF/video** showing the tool in action (terminal + env + app)
+> **Note:** This roadmap contains ideas and potential features based on initial vision and community feedback.
+> Not all features are guaranteed to be implemented. Priorities may change based on user needs, feedback,
+> and real-world usage patterns. Your input matters—feel free to share your thoughts and suggestions!
 
 ---
 
-## 🚧 Planned Improvements
-
-### 🔹 Usability & Visibility
-
-- [ ] 🔍 **Auto-discovery mode** (`--auto`) for fetching all parameters with a given prefix
-- [ ] ✍️ **Tutorial repo** showing full example with GitHub Actions
-- [x] 🛍️ **Official GitHub Action** (in Marketplace)
-
-### 🔹 Dev Experience & Adoption
-
-- [ ] ✅ **Check mode** (`--check`) to validate SSM vs existing `.env` and fail CI if out-of-sync
-- [ ] 📝 **Onboarding doc** for new teams (how to set up param-map, profiles, best practices)
-
-### 🔹 Advanced Features
-
-- [ ] ↩️ **Push mode** (`--push`) to push local `.env` back to AWS SSM
-- [ ] 🔔 **Optional webhook/Slack notifier** on secret sync (for audit/logging)
-- [ ] 🌐 **Web-based interactive demo** (optional) to test mappings live
-- [ ] 🧠 **Awesome list submissions** and community templates
+## Feature Status & Roadmap
+
+| Feature | Status | Priority | Notes |
+|---------|--------|----------|-------|
+| **Mapping-based resolution** | ✅ Implemented | - | Core functionality |
+| **`.env` file generation** | ✅ Implemented | - | Core functionality |
+| **AWS profile support** | ✅ Implemented | - | `--profile` flag |
+| **Push mode** (`--push`) | ✅ Implemented | - | [Guide](./docs/push-command.md) |
+| **GitHub Action** | ✅ Implemented | - | [Documentation](./github-action/README.md) |
+| **Onboarding documentation** | ✅ Implemented | - | [Setup guide](./docs/requirements-installation.md) |
+| **Plugin system / Multi-backend** | ❌ Planned | 🔥 Next | Starting with Azure Key Vault support |
+| **Check/sync mode** (`--check`) | ❌ Planned | High | Validate SSM vs `.env`, fail CI if out-of-sync |
+| **Auto-discovery mode** (`--auto`) | ❌ Planned | Medium | Fetch all parameters with a given prefix |
+| **Webhook/Slack notifications** | ❌ Planned | Low | Notify on secret sync for audit/logging |
+| **Hierarchical mapping** | ❌ Future | Low | Per-environment `param-map.json` |
+| **Web-based demo** | ❌ Future | Low | Interactive mapping tester |
 
 ---
 
-## 🧪 Long-term Ideas (Open to Feedback)
+## 🙌 Contribute or Suggest Ideas
 
-- [ ] 📁 Support hierarchical `param-map.json` per environment
-- [ ] 🧬 Plugin system for custom resolvers (e.g., secrets from other providers)
-
----
-
-## 🙌 Contribute or suggest ideas
-
-If you’ve faced similar problems or want to help improve this tool, feel free to open an issue, submit a PR
-or reach out.  
-Every bit of feedback helps make this tool better for the community.
-
----
+If you've faced similar problems or want to help improve this tool, feel free to:
 
-## Feature Status
+- 🐛 [Open an issue](https://github.com/macalbert/envilder/issues/new)
+- 💡 Share feature ideas and use cases
+- 🔧 Submit a Pull Request
+- 💬 Provide feedback on planned features
 
-| Feature                        | Status         | Notes |
-|--------------------------------|---------------|-------|
-| Push mode (`--push`)           | ✅ Implemented | |
-| Mapping-based secret resolution| ✅ Implemented | |
-| .env file generation           | ✅ Implemented | |
-| AWS profile support            | ✅ Implemented | |
-| GitHub Action                  | ✅ Implemented | Available as composite action |
-| Auto-discovery mode (`--auto`) | ❌ Not implemented | Planned |
-| Check/sync mode (`--check`)    | ❌ Not implemented | Planned |
-| Webhook/Slack notification     | ❌ Not implemented | Planned |
-| Hierarchical mapping           | ❌ Not implemented | Only flat JSON mapping supported |
-| Plugin system                  | ❌ Not implemented | Only AWS SSM supported |
+Every bit of feedback helps make this tool better for the community!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "envilder",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "A CLI that securely centralizes your environment variables from AWS SSM as a single source of truth",
   "main": "./lib/apps/cli/Index.js",
   "bin": {