@nitronjs/framework 0.1.0

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@nitronjs/framework",
+	"version": "0.1.0",
+	"description": "NitronJS is a modern and extensible Node.js MVC framework built on Fastify. It focuses on clean architecture, modular structure, and developer productivity, offering built-in routing, middleware, configuration management, CLI tooling, and native React integration for scalable full-stack applications.",
+	"bin": {
+		"njs": "./cli/njs.js"
+	},
+	"exports": {
+		".": "./lib/index.js"
+	},
+	"dependencies": {
+		"@fastify/cookie": "^11.0.2",
+		"@fastify/cors": "^11.2.0",
+		"@fastify/formbody": "^8.0.2",
+		"@fastify/helmet": "^13.0.2",
+		"@fastify/multipart": "^9.3.0",
+		"@fastify/static": "^8.3.0",
+		"bcrypt": "^5.1.1",
+		"dotenv": "^17.2.3",
+		"fastify": "^5.6.2",
+		"mysql2": "^3.16.0",
+		"nodemailer": "^7.0.11",
+		"react": "^19.2.3",
+		"react-dom": "^19.2.3",
+		"socket.io": "^4.8.1"
+	},
+	"devDependencies": {
+		"@babel/parser": "^7.28.5",
+		"@babel/traverse": "^7.28.5",
+		"@tailwindcss/postcss": "^4.1.18",
+		"@types/react": "^19.2.7",
+		"@types/react-dom": "^19.2.3",
+		"chokidar": "^5.0.0",
+		"esbuild": "^0.27.2",
+		"postcss": "^8.5.6",
+		"tailwindcss": "^4.1.18",
+		"typescript": "^5.9.3"
+	},
+	"keywords": [
+		"nitronjs",
+		"framework",
+		"mvc"
+	],
+	"author": "Burak AKBULUT",
+	"license": "ISC",
+	"type": "module"
+}

package/skeleton/.env.example

@@ -0,0 +1,26 @@
+APP_NAME=nitronjs
+APP_KEY=
+APP_URL=http://localhost
+APP_PORT=3000
+APP_DEV=true
+APP_DEBUG=true
+
+FILESYSTEM_DRIVER=disk
+
+# Driver: mysql | postgresql | mongodb | none
+DATABASE_DRIVER=mysql
+DATABASE_HOST=127.0.0.1
+DATABASE_PORT=3306
+DATABASE_NAME=nitronjs
+DATABASE_USERNAME=root
+DATABASE_PASSWORD=
+
+MAIL_HOST=
+MAIL_PORT=
+MAIL_USERNAME=
+MAIL_PASSWORD=
+MAIL_SECURE=
+
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_PASSWORD=

package/skeleton/app/Controllers/HomeController.js

@@ -0,0 +1,9 @@
+class HomeController {
+    static async index(request, reply) {
+        return reply.view("Site/Home", {
+            name: "NitronJS"
+        });
+    }
+}
+
+export default HomeController;

package/skeleton/app/Kernel.js

@@ -0,0 +1,11 @@
+import Authentication from "./Middlewares/Authentication.js";
+import Guest from "./Middlewares/Guest.js";
+import VerifyCsrf from "./Middlewares/VerifyCsrf.js";
+
+export default {
+    routeMiddlewares: {
+        "guest": Guest,
+        "auth": Authentication,
+        "verify-csrf": VerifyCsrf,
+    }
+};

package/skeleton/app/Middlewares/Authentication.js

@@ -0,0 +1,9 @@
+class Authentication {
+    static async handler(req, res, guardName = "user") {
+        if (!req.auth.guard(guardName).check()) {
+            return req.auth.guard(guardName).redirect();
+        }
+    }
+}
+
+export default Authentication;

package/skeleton/app/Middlewares/Guest.js

@@ -0,0 +1,9 @@
+class Guest {
+    static async handler(req, res, guardName = "user") {
+        if (req.auth.guard(guardName).check()) {
+            return req.auth.guard(guardName).home();
+        }
+    }
+}
+
+export default Guest;

package/skeleton/app/Middlewares/VerifyCsrf.js

@@ -0,0 +1,24 @@
+import sessionConfig from "../../config/session.js";
+
+class VerifyCsrf {
+    static async handler(req, res) {
+        const csrf = sessionConfig.csrf;
+        const token = req.body?.[csrf.tokenField] || req.headers[csrf.headerField];
+
+        if (!token) {
+            return res.code(403).send({
+                status: "error",
+                message: "CSRF token is required."
+            });
+        }
+
+        if (!req.session.verifyCsrfToken(token)) {
+            return res.code(403).send({
+                status: "error",
+                message: "Invalid CSRF token."
+            });
+        }
+    }
+}
+
+export default VerifyCsrf;

package/skeleton/app/Models/User.js

@@ -0,0 +1,7 @@
+import { Model } from "@nitronjs/framework";
+
+class User extends Model {
+    static table = "users";
+}
+
+export default User;

package/skeleton/config/app.js

@@ -0,0 +1,4 @@
+export default {
+    locale: 'en',
+    timezone: 'UTC',
+}

package/skeleton/config/auth.js

@@ -0,0 +1,16 @@
+import User from "../app/Models/User.js";
+
+export default {
+    defaults: {
+        guard: 'user'
+    },
+
+    guards: {
+        user: {
+            provider: User,
+            identifier: 'email',
+            home: 'home',
+            redirect: 'login'
+        }
+    }
+}

package/skeleton/config/database.js

@@ -0,0 +1,27 @@
+export default {
+    connections: {
+        mysql: {
+            driver: 'mysql',
+            charset: 'utf8mb4',
+            collation: 'utf8mb4_unicode_ci',
+            prefix: '',
+            pool: {
+                min: 2,
+                max: 10,
+                queueLimit: 100
+            }
+        },
+        
+        postgres: {
+            driver: 'postgres',
+            charset: 'utf8',
+            prefix: '',
+            schema: 'public',
+            pool: {
+                min: 2,
+                max: 10,
+                queueLimit: 100
+            }
+        }
+    }
+}

package/skeleton/config/hash.js

@@ -0,0 +1,3 @@
+export default {
+    salt_rounds: 12,
+}

package/skeleton/config/server.js

@@ -0,0 +1,28 @@
+export default {
+    web_server: {
+        maxParamLength: 150,
+        bodyLimit: 50 * 1024 * 1024,
+        trustProxy: true,
+        multipart: {
+            fieldNameSize: 100,
+            fieldSize: 2 * 1024 * 1024,
+            maxFields: 50,
+            maxFileSize: 20 * 1024 * 1024,
+            maxFiles: 10,
+            maxParts: 60,
+            attachFieldsToBody: true,
+        },
+    },
+
+    cors: {
+        origin: 'auto',
+        credentials: true,
+    },
+
+    log: {
+        channel: 'file',
+        level: 'info',
+        file: './storage/logs/app.log',
+        sync: false,
+    },
+};

package/skeleton/config/session.js

@@ -0,0 +1,21 @@
+const SESSION_LIFETIME = 1000 * 60 * 60 * 2;
+
+export default {
+    driver: "file",
+    lifetime: SESSION_LIFETIME,
+    cookieName: "session",
+    cookie: {
+        httpOnly: true,
+        secure: process.env.APP_DEV !== "true",
+        sameSite: "lax",
+        path: "/",
+        maxAge: SESSION_LIFETIME
+    },
+    csrf: {
+        enabled: true,
+        methods: ["POST", "PUT", "DELETE"],
+        except: ["/api/*"],
+        tokenField: "_csrf",
+        headerField: "x-csrf-token"
+    }
+};

package/skeleton/database/migrations/2025_01_01_00_00_users.js

@@ -0,0 +1,20 @@
+import { Schema } from "@nitronjs/framework";
+
+class Users {
+    static async up() {
+        await Schema.create("users", (table) => {
+            table.id();
+            table.string("name");
+            table.string("email").unique();
+            table.text("password");
+            table.timestamp("created_at");
+            table.timestamp("updated_at").nullable();
+        });
+    }
+
+    static async down() {
+        await Schema.dropIfExists("users");
+    }
+}
+
+export default Users;

package/skeleton/database/seeders/UserSeeder.js

@@ -0,0 +1,15 @@
+import { Hash } from "@nitronjs/framework";
+import User from "../../app/Models/User.js";
+
+class UserSeeder {
+    static async run() {
+        const user = new User();
+        user.name = "Admin";
+        user.email = "admin@example.com";
+        user.password = await Hash.make("password");
+        user.created_at = new Date();
+        await user.save();
+    }
+}
+
+export default UserSeeder;

package/skeleton/globals.d.ts

@@ -0,0 +1 @@
+import {} from 'nitronjs';

package/skeleton/package.json

@@ -0,0 +1,24 @@
+{
+    "name": "my-nitronjs-app",
+    "version": "1.0.0",
+    "type": "module",
+    "scripts": {
+        "dev": "njs dev",
+        "build": "njs build",
+        "start": "njs start",
+        "migrate": "njs migrate",
+        "migrate:seed": "njs migrate --seed",
+        "migrate:fresh": "njs migrate:fresh",
+        "migrate:fresh:seed": "njs migrate:fresh --seed",
+        "seed": "njs seed",
+        "storage:link": "njs storage:link",
+        "make:controller": "njs make:controller",
+        "make:middleware": "njs make:middleware",
+        "make:model": "njs make:model",
+        "make:migration": "njs make:migration",
+        "make:seeder": "njs make:seeder"
+    },
+    "dependencies": {
+        "@nitronjs/framework": "^0.1.0"
+    }
+}

package/skeleton/resources/views/Site/Home.tsx

@@ -0,0 +1,66 @@
+type HomeProps = {
+    name?: string;
+};
+
+export default function Home({ name = "NitronJS" }: HomeProps) {
+    return (
+        <main style={{
+            minHeight: "100vh",
+            display: "flex",
+            flexDirection: "column",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: "1.5rem",
+            color: "#fff",
+            background: "radial-gradient(circle at top, #111827, #0b0f19)",
+            fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell, Noto Sans, sans-serif",
+            padding: "4rem 1.5rem"
+        }}>
+            <h1 style={{
+                fontSize: "3.5rem",
+                lineHeight: "1.1",
+                margin: 0,
+                textAlign: "center"
+            }}>
+                Welcome to {name}
+            </h1>
+            <p style={{
+                maxWidth: "680px",
+                textAlign: "center",
+                color: "#94a3b8",
+                margin: 0,
+                fontSize: "1.125rem"
+            }}>
+                Your project is ready. Start building pages with React SSR and the NitronJS MVC structure.
+            </p>
+            <div style={{
+                display: "flex",
+                gap: "0.75rem",
+                flexWrap: "wrap",
+                justifyContent: "center"
+            }}>
+                <a href="https://nitronjs.dev/docs" style={{
+                    padding: "0.75rem 1.5rem",
+                    borderRadius: "10px",
+                    background: "#3b82f6",
+                    color: "#fff",
+                    textDecoration: "none",
+                    fontWeight: 600
+                }}>
+                    Documentation
+                </a>
+                <a href="https://nitronjs.dev" style={{
+                    padding: "0.75rem 1.5rem",
+                    borderRadius: "10px",
+                    background: "transparent",
+                    color: "#e2e8f0",
+                    textDecoration: "none",
+                    border: "1px solid #334155",
+                    fontWeight: 600
+                }}>
+                    Website
+                </a>
+            </div>
+        </main>
+    );
+}

package/skeleton/routes/web.js

@@ -0,0 +1,4 @@
+import { Route } from "@nitronjs/framework";
+import HomeController from "../app/Controllers/HomeController.js";
+
+Route.get("/", HomeController.index).name("home");

package/skeleton/tsconfig.json

@@ -0,0 +1,33 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "Node",
+        "jsx": "react-jsx",
+        "jsxImportSource": "react",
+        "lib": ["ES2022", "DOM"],
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "declarationMap": true,
+        "outDir": "./dist",
+        "rootDir": "."
+    },
+    "include": [
+        "app/**/*",
+        "config/**/*",
+        "database/**/*",
+        "routes/**/*",
+        "resources/**/*",
+        "globals.d.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "build",
+        "storage"
+    ]
+}