@lenne.tech/cli 1.6.6 → 1.6.8

package/build/templates/directus/.env.ejs

@@ -0,0 +1,26 @@
+# Directus Configuration
+# Generated by lenne.tech CLI
+# DO NOT COMMIT THIS FILE TO VERSION CONTROL
+
+# Directus Version
+DIRECTUS_VERSION='<%=props.version%>'
+
+# Directus Port
+DIRECTUS_PORT='<%=props.port%>'
+
+# Directus Security Keys (KEEP THESE SECRET)
+KEY='<%=props.keySecret%>'
+SECRET='<%=props.adminSecret%>'
+
+# Admin Credentials (CHANGE AFTER FIRST LOGIN)
+ADMIN_EMAIL='<%=props.adminEmail%>'
+ADMIN_PASSWORD='<%=props.adminPassword%>'
+
+# Database Configuration
+DB_FILENAME='<%=props.dbType === "sqlite" ? props.dbConfig.database : ""%>'
+DB_DATABASE='<%=props.dbType !== "sqlite" ? props.dbConfig.database : ""%>'
+DB_USER='<%=props.dbType !== "sqlite" ? props.dbConfig.user : ""%>'
+DB_PASSWORD='<%=props.dbType !== "sqlite" ? props.dbConfig.password : ""%>'
+
+# MySQL Root Password
+MYSQL_ROOT_PASSWORD='<%=props.dbType === "mysql" ? props.dbConfig.adminPassword : ""%>'

package/build/templates/directus/README.md.ejs

@@ -0,0 +1,159 @@
+# Directus Instance: <%= props.instanceName %>
+
+Generated by [lenne.tech CLI](https://github.com/lenneTech/cli)
+
+## Quick Start
+
+Start the Directus instance:
+```bash
+docker-compose up -d
+```
+
+Stop the instance:
+```bash
+docker-compose down
+```
+
+Restart the instance:
+```bash
+docker-compose restart
+```
+
+View logs:
+```bash
+docker-compose logs -f
+```
+
+View only Directus logs:
+```bash
+docker-compose logs -f directus
+```
+
+## Access
+
+- **URL**: http://localhost:<%= props.port %>
+- **Admin Email**: admin@example.com
+- **Admin Password**: admin
+
+**⚠️ IMPORTANT**: Change the admin password after first login!
+
+## Configuration
+
+All configuration is stored in the `.env` file. You can modify:
+- Directus version (`DIRECTUS_VERSION`)
+- Admin credentials
+- Database settings
+
+After modifying `.env`, restart the instance:
+```bash
+docker-compose down
+docker-compose up -d
+```
+
+## Security
+
+The `.env` file contains sensitive information:
+- Security keys (KEY, SECRET)
+- Admin credentials
+- Database passwords
+
+**Never commit the `.env` file to version control!**
+
+## Volumes
+
+The following Docker volumes are created for persistent data:
+- `uploads` - User uploaded files
+- `extensions` - Directus extensions
+<% if (props.dbType === 'sqlite') { -%>
+- `database` - SQLite database file
+<% } else { -%>
+- `db-data` - Database data
+<% } -%>
+
+## Backup
+
+To backup your Directus instance:
+
+1. **Backup volumes**:
+   ```bash
+   docker-compose down
+   docker run --rm -v <%= props.instanceName %>-uploads:/data -v $(pwd):/backup alpine tar czf /backup/uploads-backup.tar.gz /data
+   docker run --rm -v <%= props.instanceName %>-extensions:/data -v $(pwd):/backup alpine tar czf /backup/extensions-backup.tar.gz /data
+<% if (props.dbType === 'sqlite') { -%>
+   docker run --rm -v <%= props.instanceName %>-database:/data -v $(pwd):/backup alpine tar czf /backup/database-backup.tar.gz /data
+<% } else if (props.dbType === 'postgres') { -%>
+   docker run --rm -v <%= props.instanceName %>-db-data:/data -v $(pwd):/backup alpine tar czf /backup/db-backup.tar.gz /data
+<% } else if (props.dbType === 'mysql') { -%>
+   docker run --rm -v <%= props.instanceName %>-db-data:/data -v $(pwd):/backup alpine tar czf /backup/db-backup.tar.gz /data
+<% } -%>
+   ```
+
+2. **Backup `.env` file**:
+   ```bash
+   cp .env .env.backup
+   ```
+
+## Troubleshooting
+
+### Port already in use
+If the port is already in use, update `DIRECTUS_PORT` in `.env`, then restart:
+```bash
+docker-compose down
+docker-compose up -d
+```
+
+### Database connection issues
+Check if the database container is healthy:
+```bash
+docker-compose ps
+```
+
+View database logs:
+```bash
+docker-compose logs <%= props.dbType %>
+```
+
+### Reset instance
+To completely reset the instance (⚠️ DELETES ALL DATA):
+```bash
+docker-compose down -v
+docker-compose up -d
+```
+
+## Update Directus Version
+
+**⚠️ WARNING**: Changing Directus versions may require database migrations. Major version changes often need a fresh database.
+
+### For minor/patch updates (e.g., 10.0.0 → 10.0.1):
+1. Edit `.env` and change `DIRECTUS_VERSION`
+2. Pull the new image and restart:
+   ```bash
+   docker-compose pull
+   docker-compose down
+   docker-compose up -d
+   ```
+
+### For major updates (e.g., 10.x → 11.x):
+**Recommended**: Create a backup first, then recreate with fresh volumes:
+   ```bash
+   # Backup (see Backup section above)
+   docker-compose down -v
+   # Edit .env with new version
+   docker-compose up -d
+   ```
+
+**Note**: This will delete all data. Always backup before major version changes!
+
+## Remove Instance
+
+To completely remove this instance:
+```bash
+docker-compose down -v
+cd ..
+rm -rf <%= props.instanceName %>
+```
+
+## More Information
+
+- [Directus Documentation](https://docs.directus.io/)
+- [Docker Compose Documentation](https://docs.docker.com/compose/)

package/build/templates/directus/docker-compose.yml.ejs

@@ -0,0 +1,81 @@
+version: "3.8"
+
+services:
+<% if (props.dbType !== 'sqlite') { -%>
+  <%= props.dbType %>:
+    image: <%= props.dbConfig.image %>
+    container_name: <%= props.instanceName %>-<%= props.dbType %>
+    environment:
+<% if (props.dbType === 'postgres') { -%>
+      POSTGRES_USER: ${DB_USER}
+      POSTGRES_PASSWORD: ${DB_PASSWORD}
+      POSTGRES_DB: ${DB_DATABASE}
+<% } else if (props.dbType === 'mysql') { -%>
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${DB_DATABASE}
+      MYSQL_USER: ${DB_USER}
+      MYSQL_PASSWORD: ${DB_PASSWORD}
+<% } -%>
+    volumes:
+      - db-data:<%= props.dbType === 'postgres' ? '/var/lib/postgresql/data' : '/var/lib/mysql' %>
+    networks:
+      - directus-net
+    restart: unless-stopped
+    healthcheck:
+<% if (props.dbType === 'postgres') { -%>
+      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
+<% } else if (props.dbType === 'mysql') { -%>
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+<% } -%>
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+<% } -%>
+  directus:
+    image: directus/directus:${DIRECTUS_VERSION}
+    container_name: <%= props.instanceName %>
+    ports:
+      - "${DIRECTUS_PORT}:8055"
+    environment:
+      KEY: ${KEY}
+      SECRET: ${SECRET}
+      ADMIN_EMAIL: ${ADMIN_EMAIL}
+      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
+      DB_CLIENT: <%= props.dbConfig.client %>
+<% if (props.dbType === 'sqlite') { -%>
+      DB_FILENAME: ${DB_FILENAME}
+<% } else { -%>
+      DB_HOST: <%= props.dbType %>
+      DB_PORT: <%= props.dbConfig.port %>
+      DB_DATABASE: ${DB_DATABASE}
+      DB_USER: ${DB_USER}
+      DB_PASSWORD: ${DB_PASSWORD}
+<% } -%>
+      WEBSOCKETS_ENABLED: true
+    volumes:
+      - uploads:/directus/uploads
+      - extensions:/directus/extensions
+<% if (props.dbType === 'sqlite') { -%>
+      - database:/directus/database
+<% } -%>
+    networks:
+      - directus-net
+<% if (props.dbType !== 'sqlite') { -%>
+    depends_on:
+      <%= props.dbType %>:
+        condition: service_healthy
+<% } -%>
+    restart: unless-stopped
+
+volumes:
+<% if (props.dbType !== 'sqlite') { -%>
+  db-data:
+<% } else { -%>
+  database:
+<% } -%>
+  uploads:
+  extensions:
+
+networks:
+  directus-net:

package/docs/commands.md

@@ -14,6 +14,7 @@ This document provides a comprehensive reference for all `lt` CLI commands. For
 - [Config Commands](#config-commands)
 - [Utility Commands](#utility-commands)
 - [Database Commands](#database-commands)
+- [Directus Commands](#directus-commands)
 - [TypeScript Commands](#typescript-commands)
 - [Starter Commands](#starter-commands)
 - [Claude Commands](#claude-commands)
@@ -794,6 +795,129 @@ lt qdrant delete
 
 ---
 
+## Directus Commands
+
+### `lt directus docker-setup`
+
+Sets up a local Directus Docker instance using docker-compose.
+
+**Usage:**
+```bash
+lt directus docker-setup [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--name <name>` / `-n` | Instance name (stored in ~/.lt/directus/<name>) |
+| `--version <version>` / `-v` | Directus version (default: latest) |
+| `--database <type>` / `--db <type>` | Database type: `postgres`, `mysql`, `sqlite` |
+| `--port <number>` / `-p` | Port number (default: auto-detect starting from 8055) |
+| `--update` | Update existing instance configuration |
+| `--noConfirm` | Skip confirmation prompts |
+
+**Configuration:** `commands.directus.dockerSetup.*`, `defaults.noConfirm`
+
+**Port Auto-detection:**
+- If `--port` is not specified, the CLI automatically finds an available port starting from 8055
+- Each instance gets its own port (8055, 8056, 8057, etc.)
+- This allows running multiple Directus instances simultaneously
+
+**Generated files:**
+- `~/.lt/directus/<name>/docker-compose.yml` - Container configuration
+- `~/.lt/directus/<name>/.env` - Secrets and environment variables
+- `~/.lt/directus/<name>/README.md` - Usage instructions
+
+**Examples:**
+```bash
+# Create PostgreSQL instance (auto-detects port 8055)
+lt directus docker-setup --name my-project --database postgres
+
+# Create second instance (auto-detects port 8056)
+lt directus docker-setup --name another-project --database mysql
+
+# Create with specific port
+lt directus docker-setup --name custom-app --database sqlite --port 9000
+
+# Create with specific version
+lt directus docker-setup --name my-app --database mysql --version 10
+
+# Update existing instance
+lt directus docker-setup --name my-project --version 11 --update
+```
+
+---
+
+### `lt directus remove`
+
+Removes a Directus Docker instance and all its data.
+
+**Usage:**
+```bash
+lt directus remove [name] [options]
+```
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `name` | Instance name to remove (optional, will prompt if omitted) |
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--noConfirm` | Skip confirmation prompts |
+
+**Configuration:** `commands.directus.remove.*`, `defaults.noConfirm`
+
+**What gets removed:**
+- Stops and removes Docker containers
+- Removes all Docker volumes (database, uploads, extensions)
+- Deletes instance directory from ~/.lt/directus/
+
+**Examples:**
+```bash
+# Interactive (shows list of instances)
+lt directus remove
+
+# Remove specific instance
+lt directus remove my-project
+
+# Skip confirmation
+lt directus remove my-project --noConfirm
+```
+
+---
+
+### `lt directus typegen`
+
+Generates TypeScript types from Directus collections.
+
+**Usage:**
+```bash
+lt directus typegen [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--url <url>` / `-u` | Directus API URL |
+| `--token <token>` / `-t` | Directus API token (Administrator permissions required) |
+| `--output <path>` / `-o` | Output file path |
+| `--noConfirm` | Skip confirmation prompts |
+
+**Configuration:** `commands.directus.typegen.*`, `defaults.noConfirm`
+
+**Examples:**
+```bash
+# Interactive
+lt directus typegen
+
+# With all options
+lt directus typegen --url http://localhost:8055 --token <token> --output ./types.ts
+```
+
+---
+
 ## TypeScript Commands
 
 ### `lt typescript create`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/cli",
-  "version": "1.6.6",
+  "version": "1.6.8",
   "description": "lenne.Tech CLI: lt",
   "keywords": [
     "lenne.Tech",
@@ -59,7 +59,7 @@
     "gluegun": "5.2.2",
     "js-sha256": "0.11.1",
     "js-yaml": "4.1.1",
-    "lodash": "4.17.21",
+    "lodash": "4.17.23",
     "open": "11.0.0",
     "ts-morph": "27.0.2",
     "ts-node": "10.9.2",