expo-forge 2.1.1 → 2.1.2

package/README.md

@@ -1,4 +1,4 @@
-# 🔥 Expo Forge - Bulletproof Expo Architecture
+# 🔥 Expo Forge — Bulletproof Expo Architecture
 
 [![Test & Lint](https://github.com/moasko/expo-forge/actions/workflows/test.yml/badge.svg)](https://github.com/moasko/expo-forge/actions/workflows/test.yml)
 [![NPM Version](https://img.shields.io/npm/v/expo-forge.svg?style=flat-square)](https://www.npmjs.com/package/expo-forge)
@@ -11,89 +11,118 @@ Initialize complete projects and features with TanStack Query, Zustand, Axios, a
 
 ## ⚡ Quick Start
 
-### 1. Install globally
+### Zero Install (Recommended)
+
+No setup required. Just run and forge:
 
 ```bash
-npm install -g expo-forge
+npx create-expo-forge-app my-awesome-app
 ```
 
-### 2. Forge a new project
+That's it. ✅ Your fully configured Expo project is ready.
 
-```bash
-expo-forge init my-epic-app
-```
+---
 
-### 3. Generate powerful features
+### Global CLI Install
 
 ```bash
+# Install once
+npm install -g expo-forge
+
+# Forge a new project
+expo-forge init my-epic-app
+
+# Add features
 cd my-epic-app
 expo-forge generate feature booking
+expo-forge generate feature payment
 ```
 
 ---
 
+## 🛠️ CLI Commands
+
+| Command                              | Description                                     |
+| ------------------------------------ | ----------------------------------------------- |
+| `npx create-expo-forge-app <name>`   | **Fastest** way to forge a new project          |
+| `expo-forge init <name>`             | Initialize a new project (after global install) |
+| `expo-forge generate feature <name>` | Scaffold a complete feature module              |
+| `expo-forge --version`               | Show the current version                        |
+| `expo-forge --help`                  | Show available commands                         |
+
+---
+
 ## 🏛️ What's Inside the Forge?
 
 When you initialize a project, Expo Forge sets up a **production-ready** environment:
 
-- **🏗️ Bulletproof Structure** - Feature-based architecture (`src/features`, `src/api`, `src/hooks`).
-- **🌐 Robust API Client** - Pre-configured **Axios** with interceptors and error handling.
-- **🔄 Async State** - **TanStack Query (v5)** with optimized default configuration.
-- **🧠 Local State** - **Zustand** stores for lightweight, predictable state management.
-- **🎨 Premium Styling** - **NativeWind (Tailwind CSS)** configured with `global.css`.
-- **📱 Mobile Navigation** - **Expo Router** (File-based) with Layouts and Type-safety.
-- **🛡️ Safe Area Ready** - Integrated `SafeAreaProvider` for notched displays.
-- **🎯 Environment Ready** - `.env.example` and TypeScript path aliases (`@/*`) set up.
+- **🏗️ Bulletproof Structure** — Feature-based architecture (`src/features`, `src/api`, `src/hooks`).
+- **🌐 Pre-configured Axios** — API client with interceptors, auth headers, and error handling.
+- **🔄 TanStack Query v5** — Async state with caching, background refetch, and optimistic updates.
+- **🧠 Zustand Stores** — Lightweight, predictable global state management.
+- **🎨 NativeWind (Tailwind CSS)** — Utility-first styling with `global.css` pre-configured.
+- **📱 Expo Router** — File-based navigation with layouts and type safety.
+- **🛡️ Safe Area Ready** — `SafeAreaProvider` integrated for notched/modern devices.
+- **🎯 Environment Ready** — `.env.example` & TypeScript path aliases (`@/*`) configured.
 
 ---
 
-## 🛠️ Feature Generation
+## 🏗️ Feature Generation
 
-The `generate feature` command creates a self-contained module:
+The `generate feature` command scaffolds a self-contained module:
 
 ```text
 src/features/booking/
-├── api/              # TanStack Query custom hooks
-├── components/       # UI components (e.g., BookingCard.tsx)
+├── api/              # TanStack Query custom hooks (CRUD)
+├── components/       # UI components (e.g. BookingCard.tsx)
 ├── hooks/            # Feature-specific business logic
 ├── services/         # Pure API calls via Axios
-├── store/            # Zustand stores for this domain
+├── store/            # Zustand store for this domain
 ├── types/            # TypeScript interfaces & DTOs
-├── utils/            # Domain helpers
-├── BookingScreen.tsx # Main feature entry screen
-└── index.ts          # Clean public API for the feature
+├── utils/            # Domain-specific helpers
+├── BookingScreen.tsx # Main entry screen for this feature
+└── index.ts          # Clean public API
+```
+
+Import instantly:
+
+```typescript
+import { BookingScreen, useBookings } from "@/features/booking";
 ```
 
 ---
 
-## 🏗️ Technical stack
+## 🔧 Technical Stack
 
-- **Core**: [Expo](https://expo.dev/) + [React Native](https://reactnative.dev/)
-- **Data Fetching**: [TanStack Query](https://tanstack.com/query)
-- **State Management**: [Zustand](https://github.com/pmndrs/zustand)
-- **Styling**: [NativeWind](https://www.nativewind.dev/) (Tailwind CSS)
-- **HTTP Client**: [Axios](https://axios-http.com/)
-- **Icons**: [Lucide React Native](https://lucide.dev/)
-- **Navigation**: [Expo Router](https://docs.expo.dev/router/introduction/)
+| Layer                | Technology                                                           |
+| -------------------- | -------------------------------------------------------------------- |
+| **Runtime**          | [Expo](https://expo.dev/) + [React Native](https://reactnative.dev/) |
+| **Navigation**       | [Expo Router](https://docs.expo.dev/router/introduction/)            |
+| **Data Fetching**    | [TanStack Query v5](https://tanstack.com/query)                      |
+| **State Management** | [Zustand](https://github.com/pmndrs/zustand)                         |
+| **HTTP Client**      | [Axios](https://axios-http.com/)                                     |
+| **Styling**          | [NativeWind](https://www.nativewind.dev/) (Tailwind CSS)             |
+| **Language**         | TypeScript (strict)                                                  |
 
 ---
 
-## 📖 Technical Guides
+## 📖 Documentation
 
-- **[🏗️ Deep Architecture](ARCHITECTURE.md)** - Understanding the "Forge" way.
-- **[🎨 Branding](BRANDING.md)** - Visual identity of the CLI.
-- **[🏁 Full Demo](DEMO.md)** - Step-by-step tutorial.
-- **[🛣️ Roadmap](ROADMAP.md)** - Future of Expo Forge.
+- **[⚡ Demo & Quickstart](DEMO.md)** — Step-by-step walkthrough.
+- **[🏗️ Architecture Guide](ARCHITECTURE.md)** — Under-the-hood deep dive.
+- **[🛠️ Contribution Guide](CONTRIBUTING.md)** — Extend and customize the Forge.
+- **[🛣️ Roadmap](ROADMAP.md)** — The future of Expo Forge.
+- **[📦 Publish Guide](PUBLISH.md)** — NPM publication workflow.
 
 ---
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## 📄 License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT License — see the [LICENSE](LICENSE) file for details.
 
 ---
 

package/bin/expo-forge.js

@@ -10,6 +10,40 @@ const logger = require("../lib/logger");
 
 const pkg = require("../package.json");
 
+// ─── create-expo-forge-app mode ─────────────────────────────────────────────
+// When invoked as `npx create-expo-forge-app <appName>`, the first argument
+// is the project name directly — no subcommand needed.
+// Detect this by checking the binary name used to invoke this script.
+const invokedAs = path.basename(process.argv[1]); // e.g. "create-expo-forge-app"
+const isCreateMode = invokedAs === "create-expo-forge-app";
+
+if (isCreateMode) {
+  const projectName = process.argv[2];
+
+  if (!projectName || projectName.startsWith("-")) {
+    console.error("\n  ✦ Usage: npx create-expo-forge-app <project-name>\n");
+    console.error("  Example: npx create-expo-forge-app my-awesome-app\n");
+    process.exit(1);
+  }
+
+  (async () => {
+    try {
+      logger.rocket(`Forging your new Expo project: ${projectName}...`);
+      await initExpo.initializeProject(projectName);
+      logger.success(`\n✅ Project "${projectName}" is ready to forge!\n`);
+      logger.info(`Next steps:`);
+      logger.info(`  1. cd ${projectName}`);
+      logger.info(`  2. npx expo start`);
+    } catch (error) {
+      logger.error(`Failed to initialize project: ${error.message}`);
+      process.exit(1);
+    }
+  })();
+
+  return; // stop here — no need for the full CLI parser
+}
+
+// ─── Full CLI mode (expo-forge) ──────────────────────────────────────────────
 program
   .name("expo-forge")
   .description("Forge modern Expo apps with bulletproof architecture")
@@ -63,6 +97,7 @@ program.addHelpText(
 Examples:
   $ expo-forge init my-app
   $ expo-forge generate feature booking
+  $ npx create-expo-forge-app my-app
 
 For more information, visit: https://github.com/moasko/expo-forge
 `,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-forge",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "Forge modern Expo apps with bulletproof architecture - TanStack Query, Zustand, Axios, NativeWind",
   "author": "moasko <moasko.dev@gmail.com>",
   "license": "MIT",
@@ -41,7 +41,8 @@
     "commander": "^11.1.0"
   },
   "bin": {
-    "expo-forge": "bin/expo-forge.js"
+    "expo-forge": "bin/expo-forge.js",
+    "create-expo-forge-app": "bin/expo-forge.js"
   },
   "engines": {
     "node": ">=16.0.0",