1.0.0 • Published 4 months ago
keystone-seeder v1.0.0
✨ Keystone-Seeder
A flexible data seeder for Keystone 6 projects that helps you generate realistic test data using Faker.js.
🚀 Features
- 🎯 Easy-to-use CLI interface
- 🔧 Supports all Keystone 6 field types
- 🔄 Intelligent relation handling
- 🎲 Realistic data generation using Faker.js
- 💬 Interactive mode for relation fields
- ⚙️ Configurable seeding options
📦 Installation
npm install keystone-seeder
# or
yarn add keystone-seeder
# or
pnpm add keystone-seeder
🛠️ Usage
Keystone-Seeder provides a CLI tool to help you seed your database. Here are the available commands:
📋 List Available Models
keystone-seeder list
# or
keystone-seeder l
🌱 Seed Data
keystone-seeder seed <ModelName> [options]
Options:
-c, --count <number>
- Number of records to create (default: 10)-f, --force
- Bypass confirmations and warnings-r, --relation-mode <mode>
- How to handle relation fields:connect-one
: Use the same entity for all relationsconnect-random
: Use random entities for each relationinteractive
: Select via prompts (default)
Example:
keystone-seeder seed User -c 20 -r connect-random
⚙️ Configuration
Keystone-Seeder automatically detects your Keystone configuration file and uses it to understand your schema. No additional configuration is required.
The tool looks for your Keystone config in the following locations:
./keystone.ts
./keystone.js
./src/keystone.ts
./src/keystone.js
./config/keystone.ts
./config/keystone.js
📋 Requirements
- Node.js >= 14
- Keystone 6 project
- Prisma (automatically installed with Keystone)
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
MIT License - see LICENSE for details.
👨💻 Author
Marco Maldonado
💬 Support
If you encounter any issues or have questions, please file them in the GitHub issues page.
1.0.0
4 months ago