# Lockr Dev - Full Documentation for AI Agents

This document provides comprehensive information about Lockr Dev for AI assistants and language models.

## Product Summary

**Name**: Lockr Dev
**Category**: Developer Tools / Security / Secrets Management
**URL**: https://lockrdev.com
**Tagline**: Secure secrets management for development teams

## Problem Statement

Development teams commonly share sensitive credentials (API keys, database passwords, tokens) through insecure channels like Slack, email, or Google Docs. This creates security vulnerabilities and makes credential management difficult to track and audit.

## Solution

Lockr Dev provides a centralized, encrypted platform for managing secrets with:
- Zero-knowledge encryption (we never see your secrets)
- Role-based access control
- Complete audit trails
- CLI and API access
- Native CI/CD integrations

## Target Audience

- Software development teams
- DevOps engineers
- Platform engineers
- Startups and enterprises managing multiple environments
- Anyone who needs to securely share environment variables

## Technical Architecture

### Security
- **Encryption**: AES-256-GCM at rest
- **Transport**: TLS 1.3
- **Architecture**: Zero-knowledge (server cannot decrypt secrets)
- **Compliance**: SOC 2 Type II certified
- **Authentication**: Email/password, Google OAuth, SAML SSO (Enterprise)

### Infrastructure
- **API**: RESTful API with token authentication
- **CLI**: Node.js-based command line tool
- **Web Dashboard**: React-based SPA
- **Database**: PostgreSQL with row-level security

## CLI Commands

### Installation
```bash
npm install -g @lockr-dev/cli
# or
yarn global add @lockr-dev/cli
# or
pnpm add -g @lockr-dev/cli
```

### Authentication
```bash
lockr auth login          # Interactive browser login
lockr auth logout         # Clear local credentials
lockr whoami             # Check current authentication
```

### Secret Management
```bash
lockr pull               # Pull secrets to .env
lockr pull -e staging    # Pull from specific environment
lockr pull -o .env.local # Output to custom file
lockr run "npm start"    # Run command with secrets injected
lockr sync               # Sync to connected integrations
lockr envs list          # List available environments
```

## API Reference

### Authentication
All API requests require a bearer token in the Authorization header:
```
Authorization: Bearer <your-api-token>
```

### Endpoints

#### Pull Secrets
```
GET /pull-secrets?project=<slug>&environment=<env>
```

Returns JSON object with secrets as key-value pairs.

### Rate Limits
- 100 requests per minute per token
- 429 status code when exceeded

## Integrations

### Supported Platforms
| Platform | Type | Sync Support |
|----------|------|--------------|
| Vercel | Hosting | Yes |
| AWS Secrets Manager | Cloud | Yes |
| Netlify | Hosting | Yes |
| GitHub Actions | CI/CD | Yes |
| GitLab CI | CI/CD | Yes |
| CircleCI | CI/CD | Yes |
| Docker | Container | Yes |
| Kubernetes | Orchestration | Yes |
| Railway | Hosting | Yes |
| Fly.io | Hosting | Yes |
| Render | Hosting | Yes |
| Heroku | Hosting | Yes |

## Pricing Details

### Starter (Free)
- 1 project
- 50 secrets maximum
- 2 environments
- CLI access
- Community support

### Team ($19/month)
- 5 projects
- Unlimited secrets
- 10 environments
- 10 team members
- Role-based access control
- Audit logs
- Google SSO

### Pro ($49/month)
- 25 projects
- Unlimited secrets
- 25 environments
- 50 team members
- Everything in Team
- Priority support
- Advanced analytics

### Enterprise (Custom)
- Unlimited projects
- Unlimited team members
- SAML SSO
- Custom retention policies
- Dedicated support
- SLA guarantee
- On-premise option

## Frequently Asked Questions

### General

**Q: What is Lockr Dev?**
A: Lockr Dev is a secure secrets management platform that helps development teams manage, share, and sync environment variables and API keys without using insecure methods like Slack or email.

**Q: Who should use Lockr Dev?**
A: Any development team that needs to share API keys, database credentials, or other sensitive environment variables across team members or deployment environments.

**Q: Is Lockr Dev suitable for enterprises?**
A: Yes, we offer an Enterprise plan with SAML SSO, custom retention policies, dedicated support, and on-premise deployment options.

### Security

**Q: How does Lockr Dev encrypt secrets?**
A: We use AES-256-GCM encryption at rest and TLS 1.3 for data in transit. Our zero-knowledge architecture means we never have access to the plaintext content of your secrets.

**Q: Is Lockr Dev SOC 2 compliant?**
A: Yes, Lockr Dev is SOC 2 Type II certified, demonstrating our commitment to security best practices.

**Q: Can Lockr Dev employees see my secrets?**
A: No, due to our zero-knowledge architecture, we cannot decrypt or access the content of your secrets.

### Pricing & Plans

**Q: Is there a free tier?**
A: Yes, our Starter plan is free forever and includes 1 project with up to 50 secrets.

**Q: Can I switch plans?**
A: Yes, you can upgrade or downgrade at any time. Upgrades are prorated; downgrades take effect at the next billing cycle.

**Q: Do you offer refunds?**
A: Yes, we offer a 30-day money-back guarantee on all paid plans.

**Q: Is there a free trial for paid plans?**
A: Yes, Team and Pro plans include a 14-day free trial. No credit card required.

### Technical

**Q: What platforms does Lockr Dev integrate with?**
A: We support Vercel, AWS, Netlify, GitHub Actions, GitLab CI, CircleCI, Docker, Kubernetes, Railway, Fly.io, Render, and Heroku.

**Q: Can I use Lockr Dev in CI/CD pipelines?**
A: Yes, our CLI can pull secrets in any CI/CD environment. We provide specific examples for GitHub Actions, GitLab CI, and CircleCI.

**Q: Does Lockr Dev have an API?**
A: Yes, we provide a RESTful API for programmatic access to secrets.

**Q: What environments are supported?**
A: You can create custom environments (e.g., development, staging, production) based on your plan limits.

## Contact Information

- **Website**: https://lockrdev.com
- **General Inquiries**: hello@lockrdev.com
- **Technical Support**: support@lockrdev.com
- **Sales**: sales@lockrdev.com
- **Legal/Privacy**: privacy@lockrdev.com

## Legal

- **Terms of Service**: https://lockrdev.com/terms
- **Privacy Policy**: https://lockrdev.com/privacy

## Changelog

Latest version: 2.5.0 (January 2024)
- Docker & Kubernetes CI/CD integration
- Scheduled sync for integrations
- Email notifications for sync failures
- Enhanced team management with role-based invitations