feat: refactor FastKit structure, enhance configuration management, and update documentation

Author: abhishek-nexgen-dev

.env.fastkit

@@ -1,21 +1,37 @@
-# 🚀 FastKit – Modular, Scalable API Toolkit with TypeScript + Express
+# 🚀 FastKit – Comprehensive Full-Stack Development Toolkit
 
-FastKit is a **developer-first**, **class-based**, and **plug-and-play** toolkit built on top of Express and TypeScript to help you build APIs faster — with clean structure, reusable logic, and zero boilerplate.
+FastKit is a **developer-first**, **modular**, and **type-safe** toolkit for building modern applications with authentication, database management, and configuration handling out of the box.
 
-✅ You can use `fastKit.get()`, `post()`, `put()`, `delete()` for defining routes  
-✅ All services, controllers, middlewares, and utilities are modular and importable  
-✅ No framework lock-in — write your own logic, inject nothing
+✅ **Authentication Module** – Complete auth system with controllers and services  
+✅ **Database Config** – Multi-database support with type-safe configurations  
+✅ **Environment Management** – Automated environment setup and configuration  
+✅ **TypeScript First** – Full type safety across all modules  
+✅ **Framework Agnostic** – Use with Express, Fastify, or any Node.js framework  
+✅ **Tree-shakable** – Import only what you need for optimal bundle size
 
 ---
 
-## 🎯 Why Use FastKit?
+## 📦 Installation
+
+### Quick Start
+```bash
+npm install @nexgenstudiodev/fastkit
+```
 
-- 🧱 **Clean Architecture** – Organize your features like `Auth`, `Todo`, `Email`, etc.
-- 🔁 **Reusable Everything** – Use any controller, validator, service, or utility anywhere
-- 🧩 **Modular Setup** – Easily extend with your own modules
-- 🧠 **Zero Magic** – No decorators, no complex DI, no auto-binding
-- ⚡ **TypeScript First** – Type-safe from top to bottom
-- 🌍 **Plug-and-Play** – Use just the parts you need
+### Requirements
+- Node.js 16+ 
+- TypeScript 4.5+ (for TypeScript projects)
+
+---
+
+## 🎯 Why Choose FastKit?
+
+- 🔐 **Complete Auth System** – Login, register, JWT handling, password reset
+- �️ **Multi-Database Support** – MongoDB, PostgreSQL, MySQL, SQLite, Redis
+- ⚙️ **Smart Configuration** – Environment-based config with auto-generation
+- 🧩 **Modular Architecture** – Use individual modules or the complete package
+- 🌍 **Universal Compatibility** – Works with CommonJS, ES Modules, and TypeScript
+- 📝 **Type Safety** – Full TypeScript support with comprehensive type definitions
 
 
 
@@ -49,31 +65,251 @@ pnpm add @nexgenstudiodev/fastkit
 yarn add @nexgenstudiodev/fastkit
 ```
 
+---
 
+## 🚀 Quick Start Examples
 
+### JavaScript (CommonJS)
+```javascript
+const express = require('express');
+const { 
+  auth, 
+  config, 
+  db, 
+  AuthController, 
+  setup_FastKit_EnvFiles 
+} = require('@nexgenstudiodev/fastkit');
 
-## 🛠️ Getting Started
+const app = express();
 
-###  1. Create FastKit App
+// Setup environment files
+setup_FastKit_EnvFiles();
 
-````ts
-// server.ts
+// Use auth controller
+app.post('/api/auth/login', auth.AuthController.login);
+app.post('/api/auth/register', auth.AuthController.register);
+
+// Database configuration
+const dbConfig = {
+  type: 'mongodb',
+  url: process.env.DATABASE_URL || 'mongodb://localhost:27017/myapp'
+};
+
+app.listen(3000, () => {
+  console.log('FastKit app running on port 3000');
+});
+```
+
+### JavaScript (ES Modules)
+```javascript
 import express from 'express';
-import { FastKit } from './fastkit';
-import { loadFastKitConfig } from './config/fastkit.config';
+import { 
+  auth, 
+  config, 
+  db, 
+  AuthController, 
+  setup_FastKit_EnvFiles,
+  FastKit 
+} from '@nexgenstudiodev/fastkit';
+
+const app = express();
+
+// Setup environment and configuration
+setup_FastKit_EnvFiles();
+const appConfig = new FastKit();
+
+// Authentication routes
+app.post('/api/auth/login', AuthController.login);
+app.post('/api/auth/register', AuthController.register);
+app.post('/api/auth/logout', AuthController.logout);
+
+// Database setup
+const dbConfig = {
+  type: 'postgresql',
+  host: 'localhost',
+  port: 5432,
+  databaseName: 'myapp'
+};
+
+app.listen(3000, () => {
+  console.log('FastKit app running on port 3000');
+});
+```
+
+### TypeScript
+```typescript
+import express, { Request, Response } from 'express';
+import { 
+  auth, 
+  config, 
+  db,
+  AuthController, 
+  AuthService,
+  setup_FastKit_EnvFiles,
+  FastKit,
+  DatabaseConfig,
+  DatabaseType,
+  Config_Type 
+} from '@nexgenstudiodev/fastkit';
 
 const app = express();
-const config = loadFastKitConfig();
 
-const fastKit = new FastKit(app, config);
+// Type-safe configuration
+setup_FastKit_EnvFiles();
+const appConfig: Config_Type = new FastKit({
+  database: {
+    type: 'mongodb',
+    url: process.env.DATABASE_URL
+  },
+  auth: {
+    jwtSecret: process.env.JWT_SECRET || 'fallback-secret',
+    expiresIn: '7d'
+  }
+});
 
-// Your routes
-import './apiRoutes';
+// Type-safe database configuration
+const dbConfig: DatabaseConfig = {
+  type: 'postgresql' as DatabaseType,
+  host: 'localhost',
+  port: 5432,
+  username: 'admin',
+  password: 'password',
+  databaseName: 'myapp',
+  ssl: true
+};
+
+// Authentication with full type support
+app.post('/api/auth/login', AuthController.login);
+app.post('/api/auth/register', AuthController.register);
 
 app.listen(3000, () => {
-  console.log('🚀 Server is running on http://localhost:3000');
+  console.log('TypeScript FastKit app running on port 3000');
 });
+```
+
+---
+
+## 📚 Module Documentation
+
+### 🔐 Authentication Module
+Complete authentication system with controllers, services, and utilities.
+
+**Key Features:**
+- Login/Register endpoints
+- JWT token management  
+- Password reset functionality
+- Authentication middleware
+
+**Quick Usage:**
+```javascript
+import { AuthController, AuthService } from '@nexgenstudiodev/fastkit';
+
+// Use pre-built controllers
+app.post('/login', AuthController.login);
+```
+
+**[📖 Full Auth Documentation](src/packages/fastkit-auth/README.md)**
+
+### ⚙️ Configuration Module
+Smart configuration management with environment handling.
 
+**Key Features:**
+- Automatic environment file generation
+- Type-safe configuration objects
+- Environment-specific settings
+- Configuration validation
+
+**Quick Usage:**
+```javascript
+import { setup_FastKit_EnvFiles, FastKit } from '@nexgenstudiodev/fastkit';
+
+// Auto-generate .env files
+setup_FastKit_EnvFiles();
+
+// Type-safe configuration
+const config = new FastKit();
+```
+
+**[📖 Full Config Documentation](src/packages/fastkit-config/README.md)**
+
+### 🗄️ Database Configuration Module
+Multi-database support with type-safe configurations.
+
+**Key Features:**
+- Support for MongoDB, PostgreSQL, MySQL, SQLite, Redis
+- Type-safe database configurations
+- Connection string generation
+- Environment-based setup
+
+**Quick Usage:**
+```javascript
+import { DatabaseConfig, DatabaseType } from '@nexgenstudiodev/fastkit';
+
+const dbConfig: DatabaseConfig = {
+  type: 'mongodb',
+  url: process.env.DATABASE_URL,
+  options: { useNewUrlParser: true }
+};
+```
+
+**[📖 Full Database Config Documentation](src/packages/fastkit-db-config/README.md)**
+
+---
+
+## 🎯 Import Flexibility
+
+FastKit supports multiple import patterns for maximum flexibility:
+
+### Main Package Imports
+```javascript
+// Everything from main package
+import { auth, config, db, AuthController, FastKit } from '@nexgenstudiodev/fastkit';
+```
+
+### Sub-module Imports (Tree-shaking)
+```javascript
+// Import only what you need
+import { AuthController } from '@nexgenstudiodev/fastkit/auth';
+import { FastKit } from '@nexgenstudiodev/fastkit/config';
+import { DatabaseConfig } from '@nexgenstudiodev/fastkit/db';
+```
+
+### Namespace Imports
+```javascript
+// Organized by module
+import { auth, config, db } from '@nexgenstudiodev/fastkit';
+
+const controller = auth.AuthController;
+const dbConfig = db.DatabaseConfig;
+```
+
+
+
+
+## 🛠️ Getting Started
+
+###  1. Create FastKit App
+
+````ts
+// server.js
+
+import express from 'express';
+const app = express();
+import { FastKit , setup_FastKit_EnvFiles , Config_Type } from '@nexgenstudiodev/fastkit/config';
+
+
+setup_FastKit_EnvFiles()
+const fastKit = new FastKit(app);
+
+fastKit.get('/', (req, res) => {
+  res.send('Hello World!');
+}
+
+);
+
+fastKit.listen(3000, () => {
+  console.log('Server is running on http://localhost:3000');
+});
 
 ````