Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (keystone-seeder) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
✨ 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.