create-time2ship 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Time2Build
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# create-time2ship
+
+Create a new Time2Ship full-stack application in seconds.
+
+## Quick Start
+
+```bash
+npx create-time2ship my-app
+```
+
+## Usage
+
+### With npx (recommended)
+
+```bash
+npx create-time2ship my-app
+```
+
+### With npm
+
+```bash
+npm create time2ship my-app
+```
+
+### With yarn
+
+```bash
+yarn create time2ship my-app
+```
+
+### With pnpm
+
+```bash
+pnpm create time2ship my-app
+```
+
+## What You Get
+
+Time2Ship is a production-ready full-stack monorepo featuring:
+
+- ⚡ **Next.js 16** with React 19
+- 🛡️ **Express API** with TypeScript
+- 🗄️ **PostgreSQL** with Drizzle ORM
+- 🐳 **Docker** ready
+- 🔐 **JWT Authentication** out of the box
+- 🧪 **Comprehensive testing** setup
+- 📧 **Email service** with templates
+- 🎨 **Tailwind CSS 4**
+
+## Interactive Setup
+
+The CLI will guide you through:
+
+1. **Project Name** - Choose your project name
+2. **Description** - Optional project description
+3. **Package Manager** - npm, yarn, or pnpm
+4. **Dependencies** - Install now or later
+5. **Git** - Initialize git repository
+6. **Environment** - Auto-generate .env files
+
+## After Creation
+
+```bash
+cd my-app
+
+# Start with Docker (recommended)
+docker-compose up
+
+# Or run individually
+docker-compose up db                # Database
+cd apps/api && npm run dev          # API
+cd apps/client && npm run dev       # Client
+```
+
+Your app will be available at:
+- Frontend: http://localhost:3000
+- API: http://localhost:3001
+
+## Documentation
+
+Full documentation available in your project's README.md
+
+## Support
+
+- 📖 [Documentation](https://github.com/time2build-ai/time2ship)
+- 🐛 [Report Issues](https://github.com/time2build-ai/time2ship/issues)
+- 💬 [Discussions](https://github.com/time2build-ai/time2ship/discussions)
+
+## License
+
+ISC

package/bin/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * create-time2ship CLI
+ * Entry point for the package
+ */
+
+const currentNodeVersion = process.versions.node;
+const semver = currentNodeVersion.split('.');
+const major = parseInt(semver[0], 10);
+
+// Check Node.js version
+if (major < 18) {
+  console.error(
+    'You are running Node ' +
+      currentNodeVersion +
+      '.\n' +
+      'create-time2ship requires Node 18 or higher.\n' +
+      'Please update your version of Node.'
+  );
+  process.exit(1);
+}
+
+// Run the main CLI
+require('../src/index.js');

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-time2ship",
+  "version": "1.0.0",
+  "description": "Create a new Time2Ship full-stack application in seconds",
+  "main": "src/index.js",
+  "bin": {
+    "create-time2ship": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "node test.js",
+    "lint": "eslint .",
+    "format": "prettier --write \"**/*.js\""
+  },
+  "keywords": [
+    "create-time2ship",
+    "time2ship",
+    "boilerplate",
+    "nextjs",
+    "express",
+    "fullstack",
+    "typescript",
+    "postgresql",
+    "monorepo",
+    "template",
+    "cli"
+  ],
+  "author": "Thiago Lopez <thiago@time2build.ai>",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/time2build-ai/create-time2ship.git"
+  },
+  "bugs": {
+    "url": "https://github.com/time2build-ai/create-time2ship/issues"
+  },
+  "homepage": "https://github.com/time2build-ai/create-time2ship#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "execa": "^5.1.1",
+    "fs-extra": "^11.1.1",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2",
+    "validate-npm-package-name": "^5.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.50.0",
+    "prettier": "^3.0.3"
+  }
+}

package/src/index.js

@@ -0,0 +1,41 @@
+const path = require('path');
+const chalk = require('chalk');
+const { runPrompts } = require('./prompts');
+const { setupProject } = require('./setup');
+const { printWelcome, printSuccess, printNextSteps } = require('./utils');
+
+async function run() {
+  try {
+    // Print welcome message
+    printWelcome();
+
+    // Get user input
+    const config = await runPrompts();
+
+    if (!config) {
+      console.log(chalk.yellow('\nSetup cancelled.'));
+      process.exit(0);
+    }
+
+    // Setup the project
+    const projectPath = path.join(process.cwd(), config.projectName);
+    await setupProject(config, projectPath);
+
+    // Print success and next steps
+    printSuccess(config.projectName);
+    printNextSteps(config);
+
+  } catch (error) {
+    console.error(chalk.red('\n✗ Error:'), error.message);
+    console.error(error.stack);
+    process.exit(1);
+  }
+}
+
+// Handle unhandled rejections
+process.on('unhandledRejection', (err) => {
+  console.error(chalk.red('\nUnhandled error:'), err);
+  process.exit(1);
+});
+
+run();

package/src/prompts.js

@@ -0,0 +1,92 @@
+const prompts = require('prompts');
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+const validatePackageName = require('validate-npm-package-name');
+
+/**
+ * Validate project name
+ */
+function validateProjectName(name) {
+  const validation = validatePackageName(name);
+
+  if (!validation.validForNewPackages) {
+    const errors = [
+      ...(validation.errors || []),
+      ...(validation.warnings || [])
+    ];
+    return errors[0] || 'Invalid project name';
+  }
+
+  // Check if directory already exists
+  const targetDir = path.join(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    return `Directory "${name}" already exists. Please choose a different name.`;
+  }
+
+  return true;
+}
+
+/**
+ * Run interactive prompts
+ */
+async function runPrompts() {
+  const questions = [
+    {
+      type: 'text',
+      name: 'projectName',
+      message: 'What is your project name?',
+      initial: 'my-time2ship-app',
+      validate: validateProjectName
+    },
+    {
+      type: 'text',
+      name: 'description',
+      message: 'Project description (optional):',
+      initial: 'A Time2Ship application'
+    },
+    {
+      type: 'select',
+      name: 'packageManager',
+      message: 'Which package manager do you want to use?',
+      choices: [
+        { title: 'npm', value: 'npm' },
+        { title: 'yarn', value: 'yarn' },
+        { title: 'pnpm', value: 'pnpm' }
+      ],
+      initial: 0
+    },
+    {
+      type: 'confirm',
+      name: 'installDeps',
+      message: 'Install dependencies now?',
+      initial: true
+    },
+    {
+      type: 'confirm',
+      name: 'initGit',
+      message: 'Initialize a git repository?',
+      initial: true
+    },
+    {
+      type: 'confirm',
+      name: 'setupEnv',
+      message: 'Create environment files (.env)?',
+      initial: true
+    }
+  ];
+
+  const response = await prompts(questions, {
+    onCancel: () => {
+      console.log(chalk.red('\n✗ Setup cancelled'));
+      process.exit(0);
+    }
+  });
+
+  return response;
+}
+
+module.exports = {
+  runPrompts,
+  validateProjectName
+};

package/src/setup.js

@@ -0,0 +1,177 @@
+const fs = require('fs-extra');
+const path = require('path');
+const ora = require('ora');
+const chalk = require('chalk');
+const { execSync } = require('child_process');
+const { execa } = require('execa');
+const { generateEnvFiles } = require('./templates');
+
+/**
+ * Clone the Time2Ship repository
+ */
+async function cloneRepository(targetDir) {
+  const spinner = ora('Cloning Time2Ship boilerplate...').start();
+
+  try {
+    // Clone from GitHub
+    execSync(
+      `git clone --depth 1 https://github.com/time2build-ai/time2ship.git "${targetDir}"`,
+      { stdio: 'pipe' }
+    );
+
+    // Remove .git directory
+    await fs.remove(path.join(targetDir, '.git'));
+
+    spinner.succeed('Boilerplate cloned successfully');
+  } catch (error) {
+    spinner.fail('Failed to clone repository');
+    throw new Error(`Git clone failed: ${error.message}`);
+  }
+}
+
+/**
+ * Install dependencies
+ */
+async function installDependencies(projectPath, packageManager) {
+  const spinner = ora(`Installing dependencies with ${packageManager}...`).start();
+
+  try {
+    await execa(packageManager, ['install'], {
+      cwd: projectPath,
+      stdio: 'pipe'
+    });
+
+    spinner.succeed('Dependencies installed');
+  } catch (error) {
+    spinner.fail('Failed to install dependencies');
+    console.log(chalk.yellow('\nYou can install dependencies manually later by running:'));
+    console.log(chalk.cyan(`  cd ${path.basename(projectPath)}`));
+    console.log(chalk.cyan(`  ${packageManager} install\n`));
+  }
+}
+
+/**
+ * Initialize git repository
+ */
+async function initializeGit(projectPath) {
+  const spinner = ora('Initializing git repository...').start();
+
+  try {
+    execSync('git init', { cwd: projectPath, stdio: 'pipe' });
+    execSync('git add .', { cwd: projectPath, stdio: 'pipe' });
+    execSync('git commit -m "Initial commit from create-time2ship"', {
+      cwd: projectPath,
+      stdio: 'pipe'
+    });
+
+    spinner.succeed('Git repository initialized');
+  } catch (error) {
+    spinner.fail('Failed to initialize git');
+    console.log(chalk.yellow('You can initialize git manually later.'));
+  }
+}
+
+/**
+ * Setup environment files
+ */
+async function setupEnvironmentFiles(projectPath, config) {
+  const spinner = ora('Creating environment files...').start();
+
+  try {
+    const { apiEnv, clientEnv } = generateEnvFiles(config);
+
+    // Write API .env
+    const apiEnvPath = path.join(projectPath, 'apps', 'api', '.env');
+    await fs.writeFile(apiEnvPath, apiEnv);
+
+    // Write Client .env
+    const clientEnvPath = path.join(projectPath, 'apps', 'client', '.env.local');
+    await fs.writeFile(clientEnvPath, clientEnv);
+
+    spinner.succeed('Environment files created');
+  } catch (error) {
+    spinner.fail('Failed to create environment files');
+    console.log(chalk.yellow('\nYou can create environment files manually:'));
+    console.log(chalk.cyan('  cp apps/api/.env.example apps/api/.env'));
+    console.log(chalk.cyan('  cp apps/client/.env.example apps/client/.env.local\n'));
+  }
+}
+
+/**
+ * Update package.json with project details
+ */
+async function updateProjectPackageJson(projectPath, config) {
+  const spinner = ora('Updating package.json...').start();
+
+  try {
+    // Update root package.json
+    const rootPkgPath = path.join(projectPath, 'package.json');
+    const rootPkg = await fs.readJson(rootPkgPath);
+
+    rootPkg.name = config.projectName;
+    rootPkg.description = config.description;
+    rootPkg.version = '0.1.0';
+
+    await fs.writeJson(rootPkgPath, rootPkg, { spaces: 2 });
+
+    // Update client package.json
+    const clientPkgPath = path.join(projectPath, 'apps', 'client', 'package.json');
+    const clientPkg = await fs.readJson(clientPkgPath);
+
+    clientPkg.name = `${config.projectName}-client`;
+    clientPkg.version = '0.1.0';
+
+    await fs.writeJson(clientPkgPath, clientPkg, { spaces: 2 });
+
+    // Update API package.json
+    const apiPkgPath = path.join(projectPath, 'apps', 'api', 'package.json');
+    const apiPkg = await fs.readJson(apiPkgPath);
+
+    apiPkg.name = `${config.projectName}-api`;
+    apiPkg.version = '0.1.0';
+
+    await fs.writeJson(apiPkgPath, apiPkg, { spaces: 2 });
+
+    spinner.succeed('package.json files updated');
+  } catch (error) {
+    spinner.warn('Could not update package.json files');
+  }
+}
+
+/**
+ * Main setup function
+ */
+async function setupProject(config, projectPath) {
+  console.log(); // Empty line for spacing
+
+  // 1. Clone repository
+  await cloneRepository(projectPath);
+
+  // 2. Update package.json files
+  await updateProjectPackageJson(projectPath, config);
+
+  // 3. Setup environment files
+  if (config.setupEnv) {
+    await setupEnvironmentFiles(projectPath, config);
+  }
+
+  // 4. Install dependencies
+  if (config.installDeps) {
+    await installDependencies(projectPath, config.packageManager);
+  }
+
+  // 5. Initialize git
+  if (config.initGit) {
+    await initializeGit(projectPath);
+  }
+
+  console.log(); // Empty line for spacing
+}
+
+module.exports = {
+  setupProject,
+  cloneRepository,
+  installDependencies,
+  initializeGit,
+  setupEnvironmentFiles
+};

package/src/templates.js

@@ -0,0 +1,87 @@
+const crypto = require('crypto');
+
+/**
+ * Generate a random secret
+ */
+function generateSecret(length = 32) {
+  return crypto.randomBytes(length).toString('base64');
+}
+
+/**
+ * Generate API .env file content
+ */
+function generateApiEnv(config) {
+  return `# 🖥️ Server Configuration
+NODE_ENV=development
+PORT=3001
+
+# 🗄️ Database Configuration
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=${config.projectName.replace(/-/g, '_')}_db
+DB_USER=postgres
+DB_PASSWORD=postgres
+
+# 🔐 JWT Secrets (Auto-generated - Change in production!)
+JWT_ACCESS_SECRET=${generateSecret()}
+JWT_REFRESH_SECRET=${generateSecret()}
+
+# 📧 Email Configuration (Update with your SMTP details)
+EMAIL_HOST=smtp.gmail.com
+EMAIL_PORT=587
+EMAIL_USER=your-email@gmail.com
+EMAIL_PASSWORD=your-app-password
+EMAIL_FROM=noreply@${config.projectName}.com
+
+# 🌐 URLs
+CLIENT_URL=http://localhost:3000
+API_URL=http://localhost:3001
+
+# 🔑 OTP Configuration
+OTP_EXPIRY_MINUTES=10
+`;
+}
+
+/**
+ * Generate Client .env file content
+ */
+function generateClientEnv(config) {
+  return `# 🌐 API Configuration
+NEXT_PUBLIC_API_URL=http://localhost:3001
+API_URL=http://api:3001
+
+# 📱 App Configuration
+NEXT_PUBLIC_APP_NAME=${config.projectName}
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+`;
+}
+
+/**
+ * Generate both environment files
+ */
+function generateEnvFiles(config) {
+  return {
+    apiEnv: generateApiEnv(config),
+    clientEnv: generateClientEnv(config)
+  };
+}
+
+/**
+ * Update package.json content
+ */
+function updatePackageJson(packageJson, config) {
+  return {
+    ...packageJson,
+    name: config.projectName,
+    description: config.description,
+    version: '0.1.0'
+  };
+}
+
+module.exports = {
+  generateEnvFiles,
+  generateApiEnv,
+  generateClientEnv,
+  updatePackageJson,
+  generateSecret
+};

package/src/utils.js

@@ -0,0 +1,106 @@
+const chalk = require('chalk');
+
+/**
+ * Print welcome banner
+ */
+function printWelcome() {
+  console.log();
+  console.log(chalk.blue.bold('  ╔════════════════════════════════════╗'));
+  console.log(chalk.blue.bold('  ║                                    ║'));
+  console.log(chalk.blue.bold('  ║   🚀  Welcome to Time2Ship  🚀     ║'));
+  console.log(chalk.blue.bold('  ║                                    ║'));
+  console.log(chalk.blue.bold('  ║   Ship your ideas faster!          ║'));
+  console.log(chalk.blue.bold('  ║                                    ║'));
+  console.log(chalk.blue.bold('  ╚════════════════════════════════════╝'));
+  console.log();
+}
+
+/**
+ * Print success message
+ */
+function printSuccess(projectName) {
+  console.log();
+  console.log(chalk.green.bold('  ✓ Success!'), `Your project "${projectName}" is ready!`);
+  console.log();
+}
+
+/**
+ * Print next steps
+ */
+function printNextSteps(config) {
+  const { projectName, installDeps, setupEnv, packageManager } = config;
+
+  console.log(chalk.cyan.bold('📋 Next Steps:\n'));
+
+  // Step 1: Navigate to directory
+  console.log(chalk.white('  1. Navigate to your project:'));
+  console.log(chalk.gray(`     cd ${projectName}\n`));
+
+  // Step 2: Install dependencies (if not done)
+  if (!installDeps) {
+    console.log(chalk.white('  2. Install dependencies:'));
+    console.log(chalk.gray(`     ${packageManager} install\n`));
+  }
+
+  // Step 3: Configure environment (if not done)
+  if (!setupEnv) {
+    console.log(chalk.white(`  ${installDeps ? '2' : '3'}. Set up environment variables:`));
+    console.log(chalk.gray('     cp apps/api/.env.example apps/api/.env'));
+    console.log(chalk.gray('     cp apps/client/.env.example apps/client/.env.local'));
+    console.log(chalk.yellow('     ⚠️  Update the .env files with your configuration\n'));
+  } else {
+    console.log(chalk.white(`  ${installDeps ? '2' : '3'}. Review and update environment variables:`));
+    console.log(chalk.gray('     apps/api/.env'));
+    console.log(chalk.gray('     apps/client/.env.local'));
+    console.log(chalk.yellow('     ⚠️  JWT secrets have been auto-generated\n'));
+  }
+
+  // Step 4: Start development
+  const stepNum = installDeps && setupEnv ? '3' : installDeps || setupEnv ? '4' : '5';
+  console.log(chalk.white(`  ${stepNum}. Start development with Docker:`));
+  console.log(chalk.gray('     docker-compose up\n'));
+
+  console.log(chalk.white('     Or run services individually:'));
+  console.log(chalk.gray('     # Terminal 1 - Database'));
+  console.log(chalk.gray('     docker-compose up db\n'));
+  console.log(chalk.gray('     # Terminal 2 - API'));
+  console.log(chalk.gray('     cd apps/api && npm run dev\n'));
+  console.log(chalk.gray('     # Terminal 3 - Client'));
+  console.log(chalk.gray('     cd apps/client && npm run dev\n'));
+
+  // URLs
+  console.log(chalk.cyan.bold('🌐 Your app will be available at:\n'));
+  console.log(chalk.white('   Frontend:'), chalk.blue.underline('http://localhost:3000'));
+  console.log(chalk.white('   API:     '), chalk.blue.underline('http://localhost:3001'));
+  console.log(chalk.white('   Database:'), chalk.gray('localhost:5432\n'));
+
+  // Documentation
+  console.log(chalk.cyan.bold('📚 Documentation:\n'));
+  console.log(chalk.gray(`   Check out the README.md in your project for detailed docs\n`));
+
+  // Happy coding
+  console.log(chalk.green.bold('  Happy shipping! 🚀\n'));
+
+  // Support
+  console.log(chalk.gray('  Need help? Visit: ') + chalk.blue.underline('https://github.com/time2build-ai/time2ship'));
+  console.log();
+}
+
+/**
+ * Check if a command exists
+ */
+function commandExists(command) {
+  try {
+    require('child_process').execSync(`which ${command}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+module.exports = {
+  printWelcome,
+  printSuccess,
+  printNextSteps,
+  commandExists
+};