create-droid 1.0.1 → 1.0.4

package/README.md

@@ -42,16 +42,30 @@ Follow the interactive prompts:
 ```bash
 cd my-app
 
-# Build and verify the project
-./gradlew build
+# Start "Live Reload" mode (Continuous Build)
+# Edits will auto-compile and install on your connected device!
+npm run dev
 
-# Install on a connected device/emulator
-./gradlew installDebug
+# Or build manually
+npm run build
 ```
 
 ## What's Inside?
 
-The generated project is **clean** and follows modern best practices:
+The generated project is **clean** and follows modern best practices. It includes a `package.json` with convenience scripts:
+
+*   `npm run dev`: Watches your code and auto-deploys changes (`./gradlew -t installDebug`).
+*   `npm run build`: Generates a release APK (`./gradlew assembleRelease`).
+*   `npm test`: Runs unit tests (`./gradlew test`).
+
+### 📱 ADB Scripts (Wireless Debugging)
+
+We include a robust `adb` wrapper that works even if `adb` is not in your PATH (uses the local SDK):
+
+*   `npm run adb:devices`: List connected devices.
+*   `npm run adb:connect <ip>`: Connect to a device via Wi-Fi.
+*   `npm run adb:pair <ip> <code>`: Pair a new device (Android 11+).
+*   `npm run adb:logcat`: View device logs.
 
 ```text
 my-app/

package/dist/template/generateProject.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { execa } from 'execa';
 import { CONSTANTS } from '../utils/constants.js';
 import { logger } from '../utils/logger.js';
 const __filename = fileURLToPath(import.meta.url);
@@ -20,6 +21,11 @@ export async function generateProject(options) {
     // 3. Copy Base
     logger.info(`Copying base template from ${baseTemplate}...`);
     await fs.copy(baseTemplate, projectPath);
+    // Rename _gitignore to .gitignore
+    const gitignorePath = path.join(projectPath, '_gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        await fs.move(gitignorePath, path.join(projectPath, '.gitignore'));
+    }
     // 4. Copy UI specific files
     if (fs.existsSync(uiTemplate)) {
         logger.info(`Applying ${uiType} template...`);
@@ -58,6 +64,47 @@ export async function generateProject(options) {
     // Create local.properties with SDK location
     const localProperties = `sdk.dir=${sdkPath}`;
     await fs.writeFile(path.join(projectPath, 'local.properties'), localProperties);
+    // 6. Setup NPM Scripts (The "Vite-like" experience)
+    logger.info('Adding npm convenience scripts...');
+    const packageJson = {
+        name: projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-'),
+        version: "0.1.0",
+        private: true,
+        scripts: {
+            "dev": "./gradlew -t installDebug",
+            "start": "npm run dev",
+            "build": "./gradlew assembleRelease",
+            "build:debug": "./gradlew assembleDebug",
+            "test": "./gradlew test",
+            "lint": "./gradlew lint",
+            "clean": "./gradlew clean",
+            "help": "./gradlew --help",
+            "adb": "node scripts/adb.js",
+            "adb:devices": "npm run adb devices",
+            "adb:connect": "npm run adb connect",
+            "adb:pair": "npm run adb pair",
+            "adb:logcat": "npm run adb logcat",
+            "adb:reverse": "npm run adb reverse tcp:8081 tcp:8081"
+        }
+    };
+    await fs.writeJSON(path.join(projectPath, 'package.json'), packageJson, { spaces: 2 });
+    // Ensure scripts dir exists (since we copy base first, but adb.js is new)
+    // Wait, templates/base/scripts/adb.js is ALREADY in the base template.
+    // We just need to ensure the `scripts` folder is copied correctly.
+    // Since we copy `templates/base`, it should be fine.
+    // Make scripts executable if needed (node doesn't need +x but good practice)
+    // await fs.chmod(path.join(projectPath, 'scripts/adb.js'), 0o755);
+    // 7. Initialize Git
+    try {
+        logger.info('Initializing git repository...');
+        await execa('git', ['init'], { cwd: projectPath });
+        await execa('git', ['add', '.'], { cwd: projectPath });
+        await execa('git', ['commit', '-m', 'Initial commit via create-droid'], { cwd: projectPath });
+        logger.success('Git repository initialized.');
+    }
+    catch (e) {
+        logger.warn('Failed to initialize git repository. You may need to run "git init" manually.');
+    }
 }
 async function patchFile(filePath, replacements) {
     if (!fs.existsSync(filePath))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-droid",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "The fastest way to start an Android project. No Studio required.",
   "author": "YELrhilassi",
   "license": "MIT",

package/templates/base/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Wed Feb 18 14:07:35 PST 2026
+gradle.version=9.2.0

package/templates/base/_gitignore

@@ -0,0 +1,23 @@
+# Gradle
+.gradle/
+build/
+app/build/
+
+# Local configuration file (sdk.dir is here)
+local.properties
+
+# Android Studio / IntelliJ
+.idea/
+*.iml
+*.iws
+*.ipr
+*.xml
+
+# Mac
+.DS_Store
+
+# Kotlin
+.kotlin/
+
+# Secrets (if any)
+secrets.properties

package/templates/base/app/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#3DDC84"
+        android:pathData="M0,0h108v108h-108z" />
+</vector>

package/templates/base/app/src/main/res/drawable/ic_launcher_foreground.xml

@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M66,66L66,66C66,66 66,66 66,66L66,66C66,66 66,66 66,66L66,66C66,66 66,66 66,66L66,66ZM42,42L42,42C42,42 42,42 42,42L42,42C42,42 42,42 42,42L42,42C42,42 42,42 42,42L42,42ZM54,24L54,24C54,24 54,24 54,24L54,24C54,24 54,24 54,24L54,24C54,24 54,24 54,24L54,24ZM84,54L84,54C84,54 84,54 84,54L84,54C84,54 84,54 84,54L84,54C84,54 84,54 84,54L84,54ZM24,54L24,54C24,54 24,54 24,54L24,54C24,54 24,54 24,54L24,54C24,54 24,54 24,54L24,54ZM54,84L54,84C54,84 54,84 54,84L54,84C54,84 54,84 54,84L54,84C54,84 54,84 54,84L54,84Z" />
+</vector>

package/templates/base/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

package/templates/base/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

package/templates/base/app/src/main/res/values/strings.xml

@@ -0,0 +1,3 @@
+<resources>
+    <string name="app_name">{{PROJECT_NAME}}</string>
+</resources>

package/templates/base/app/src/main/res/values/themes.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="Theme.MyApplication" parent="android:Theme.Material.Light.NoActionBar" />
+</resources>

package/templates/base/app/src/main/res/xml/backup_rules.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<full-backup-content>
+    <include domain="sharedpref" path="."/>
+    <include domain="database" path="."/>
+</full-backup-content>

package/templates/base/app/src/main/res/xml/data_extraction_rules.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<data-extraction-rules>
+    <cloud-backup>
+        <include domain="sharedpref" path="."/>
+        <include domain="database" path="."/>
+    </cloud-backup>
+    <device-transfer>
+        <include domain="sharedpref" path="."/>
+        <include domain="database" path="."/>
+    </device-transfer>
+</data-extraction-rules>

package/templates/base/scripts/adb.js

@@ -0,0 +1,47 @@
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 1. Find SDK Location from local.properties
+const projectRoot = path.resolve(__dirname, '..');
+const localPropertiesPath = path.join(projectRoot, 'local.properties');
+let sdkPath = process.env.ANDROID_HOME;
+
+if (fs.existsSync(localPropertiesPath)) {
+  const content = fs.readFileSync(localPropertiesPath, 'utf8');
+  const match = content.match(/^sdk\.dir=(.*)$/m);
+  if (match) {
+    sdkPath = match[1].trim().replace(/\\\\/g, '\\'); // Handle Windows escaping if present
+  }
+}
+
+if (!sdkPath) {
+  console.error('❌ Could not find SDK location. Set ANDROID_HOME or create local.properties.');
+  process.exit(1);
+}
+
+// 2. Resolve ADB binary
+const isWin = os.platform() === 'win32';
+const adbBinary = isWin ? 'adb.exe' : 'adb';
+const adbPath = path.join(sdkPath, 'platform-tools', adbBinary);
+
+if (!fs.existsSync(adbPath)) {
+    // Fallback to global adb if local not found
+    console.warn(`⚠️  Local ADB not found at ${adbPath}. Trying global 'adb'...`);
+}
+
+// 3. Run ADB with arguments
+const args = process.argv.slice(2);
+const finalAdbPath = fs.existsSync(adbPath) ? adbPath : 'adb';
+
+const child = spawn(finalAdbPath, args, { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  console.error(`❌ Failed to start ADB: ${err.message}`);
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code);
+});