create-aziz-app 2.0.14 → 3.0.0

package/README.md

@@ -0,0 +1,227 @@
+# ⚡ Aziz.js
+
+> A lightweight Next.js clone — file-based routing, React hooks, server-side API routes, ES module imports. **Zero dependencies. Instant startup.**
+
+```bash
+npx create-aziz-app my-app
+```
+
+---
+
+## What is this?
+
+Aziz.js gives you the Next.js developer experience without the weight:
+
+| | Aziz.js | Next.js |
+|--|---------|---------|
+| Bundle size | **~50KB** | ~400KB+ |
+| Dependencies | **0** | 20+ |
+| Startup time | **< 1s** | 10–30s |
+| `page.js` routing | ✅ | ✅ |
+| `layout.js` | ✅ | ✅ |
+| API routes | ✅ | ✅ |
+| `NextResponse` | ✅ | ✅ |
+| React hooks | ✅ | ✅ |
+| ES module imports | ✅ | ✅ |
+| `@/` alias | ✅ | ✅ |
+| Live reload | ✅ | ✅ |
+| SSR / SSG | ❌ | ✅ |
+
+---
+
+## Getting Started
+
+```bash
+npx create-aziz-app my-app
+cd my-app
+npm run dev
+```
+
+The CLI will ask you:
+- **Project name**
+- **Port** (default: 3000)
+- **CSS framework** — None / Bootstrap / Tailwind
+- **Include examples?**
+- **Include docs?**
+
+---
+
+## Project Structure
+
+```
+my-app/
+├── index.html              ← entry point
+├── app/
+│   ├── layout.js           ← root layout
+│   ├── page.js             ← route: /
+│   ├── about/
+│   │   └── page.js         ← route: /about
+│   └── blog/
+│       └── [slug]/
+│           └── page.js     ← route: /blog/:slug
+├── api/
+│   └── users.js            ← /api/users  (server-side)
+├── components/
+│   ├── Navbar.js
+│   └── Footer.js
+├── lib/
+│   └── db.js
+├── models/
+│   └── User.js
+└── styles/
+    └── globals.css
+```
+
+---
+
+## Pages
+
+```js
+// app/about/page.js  →  /about
+/** @jsx h */
+import { h } from '/_framework/runtime.js';
+
+export default function Page() {
+    const [count, setCount] = useState(0);
+
+    return (
+        <div>
+            <h1>About</h1>
+            <p>Count: {count}</p>
+            <button onClick={() => setCount(c => c + 1)}>+</button>
+        </div>
+    );
+}
+```
+
+---
+
+## Layouts
+
+```js
+// app/layout.js  →  wraps every page
+/** @jsx h */
+import { h } from '/_framework/runtime.js';
+import Navbar from '/components/Navbar.js';
+
+export default function Layout({ children }) {
+    return (
+        <div>
+            <Navbar />
+            <main>{children}</main>
+        </div>
+    );
+}
+```
+
+---
+
+## API Routes
+
+```js
+// api/users.js  →  /api/users
+const { NextResponse } = require('../modules/next-response');
+
+async function GET(request) {
+    const { searchParams } = new URL(request.url);
+    const id = searchParams.get('id');
+    // fetch from DB...
+    return NextResponse.json({ users: [] });
+}
+
+async function POST(request) {
+    const { name, email } = await request.json();
+    // save to DB...
+    return NextResponse.json({ created: true }, { status: 201 });
+}
+
+module.exports = { GET, POST };
+```
+
+---
+
+## Imports
+
+```js
+// Framework
+import { h }        from '/_framework/runtime.js';
+import { navigate } from '/_framework/router.js';
+
+// Absolute paths
+import Navbar from '/components/Navbar.js';
+
+// @/ alias
+import connectDB from '@/lib/db';
+import User      from '@/models/User';
+
+// npm packages (install first, then import)
+import mongoose from 'mongoose';
+import bcrypt   from 'bcryptjs';
+import jwt      from 'jsonwebtoken';
+```
+
+---
+
+## React Hooks
+
+All hooks work exactly like React — no imports needed in pages:
+
+```js
+const [count, setCount]   = useState(0);
+const [user, setUser]     = useState(null);
+
+useEffect(() => {
+    fetchUser().then(setUser);
+}, []);
+
+const doubled = useMemo(() => count * 2, [count]);
+const ref     = useRef(null);
+
+const [state, dispatch] = useReducer(reducer, initialState);
+
+const theme = useContext(ThemeContext);
+
+const [name, setName] = useLocalStorage('name', '');
+
+const { data, loading, error } = useFetch('/api/users');
+```
+
+---
+
+## Navigation
+
+```js
+import { navigate, Link, useRouter, useParams, useSearchParams } from '/_framework/router.js';
+
+// Programmatic
+navigate('/about');
+
+// Component
+<Link href="/about">About</Link>
+
+// Hook
+const { pathname, push, back } = useRouter();
+
+// Dynamic route params  (/blog/[slug])
+const { slug } = useParams();
+
+// Query string  (/search?q=hello)
+const searchParams = useSearchParams();
+const q = searchParams.get('q');
+```
+
+---
+
+## Full docs
+
+See [README.md](template/README.md) inside your generated project for the complete guide.
+
+---
+
+## Author
+
+**Syed Muhammad Aziz Ahmed**
+
+## License
+
+AZIZ

package/bin/create-aziz-app.js

@@ -17,14 +17,14 @@ function question(query) {
 
 // Main function
 async function main() {
-    console.log(`\n⚡ Welcome to Aziz App Creator!\n`);
-    console.log(`🎨 A React-like framework with state management, routing, and API routes\n`);
+    console.log(`\n⚡ Welcome to Aziz.js!\n`);
+    console.log(`🎨 A lightweight Next.js clone — file-based routing, React hooks, API routes\n`);
 
     // Get project name
     let projectName = process.argv[2];
     if (!projectName) {
-        projectName = await question('📁 Project name (my-aziz-app): ');
-        projectName = projectName.trim() || 'my-aziz-app';
+        projectName = await question('📁 Project name (my-aziz-js-app): ');
+        projectName = projectName.trim() || 'my-aziz-js-app';
     }
 
     // Validate project name
@@ -97,7 +97,7 @@ async function main() {
     setupCSSFramework(targetDir, features.cssFramework);
 
     console.log(`✅ Done! Your project is ready.\n`);
-    console.log(`🎉 Welcome to Aziz App - A React-like Framework\n`);
+    console.log(`🎉 Welcome to Aziz.js\n`);
     console.log(`📁 Created project: ${projectName}\n`);
     console.log(`👉 Get started:\n`);
     console.log(`   cd ${projectName}`);
@@ -307,7 +307,7 @@ function Navbar() {
         <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
             <div class="container-fluid">
                 <span class="navbar-brand" onClick={() => navigate("home")} style={{ cursor: 'pointer' }}>
-                    ⚡ AzizApp
+                    ⚡ Aziz.js
                 </span>
                 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
                     <span class="navbar-toggler-icon"></span>
@@ -348,7 +348,7 @@ function Footer() {
     return (
         <footer class="bg-dark text-light text-center py-3 mt-auto">
             <div class="container">
-                <p class="mb-0">Made with ⚡ AzizApp</p>
+                <p class="mb-0">Made with ⚡ Aziz.js</p>
             </div>
         </footer>
     );
@@ -382,7 +382,7 @@ function Navbar() {
                         class="text-primary text-xl font-bold cursor-pointer hover:text-blue-300 transition"
                         onClick={() => navigate("home")}
                     >
-                        ⚡ AzizApp
+                        ⚡ Aziz.js
                     </span>
                     <div class="flex space-x-4">
                         <a href="#/home" class={\`px-3 py-2 rounded-md text-sm font-medium transition \${path === "home" ? "bg-primary text-dark" : "text-gray-300 hover:bg-gray-700 hover:text-white"}\`}>
@@ -419,7 +419,7 @@ function Footer() {
     return (
         <footer class="bg-dark text-gray-400 text-center py-4 mt-auto">
             <div class="container mx-auto">
-                <p>Made with ⚡ AzizApp</p>
+                <p>Made with ⚡ Aziz.js</p>
             </div>
         </footer>
     );

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "create-aziz-app",
-  "version": "2.0.14",
-  "description": "A React-like framework with state management, routing, and API routes - Create apps with auto-import, live reload, and Next.js-like features",
+  "version": "3.0.0",
+  "description": "Create Aziz.js apps — lightweight Next.js clone with file-based routing, React hooks, and API routes",
   "keywords": [
-    "react",
-    "full-stack",
+    "aziz.js",
+    "nextjs",
     "framework",
     "cli",
     "create-app",
-    "routing",
-    "state-management",
+    "file-based-routing",
+    "react-hooks",
     "api-routes",
-    "live-reload"
+    "live-reload",
+    "lightweight"
   ],
-  "license": "AZIZ",
+  "license": "MIT",
   "author": "Syed Muhammad Aziz Ahmed",
   "type": "commonjs",
   "files": [
@@ -24,8 +25,6 @@
     "create-aziz-app": "bin/create-aziz-app.js"
   },
   "scripts": {
-    "dev": "cd template && node scripts/dev-server.js",
-    "build": "cd template && node scripts/generate-imports.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "cd template && node scripts/dev-server.js"
   }
 }