🚀 Flint Dart — Version 1.0.0+12 #

🚀 Flint Dart — Version 1.0.0+11 #

🧩 Updates & Improvements #

• 🛠️ Bug Fixes: Resolved several minor issues across the framework for improved stability.
• ⚙️ Patch Enhancements: Applied multiple patches to improve reliability and developer experience.
• 🧰 CLI Upgrade: The CLI has been updated and upgraded with new commands and performance improvements.
• 🔄 Update System Added: Introduced support for automatic update checks and smoother upgrade handling.

Flint Dart continues to evolve toward a more seamless, developer-friendly backend framework for Dart.

🚀 Flint Dart — Version 1.0.0+10 #

Flint Dart continues to evolve into a complete backend + UI ecosystem for Dart, combining powerful server-side tools with a new rendering engine — Flint UI.

🎨 Flint UI — Cross-Platform Rendering System #

Flint UI introduces a Flutter-like declarative UI engine for generating HTML, email layouts, and console output directly from Dart — no React or HTML strings required.

✨ Core Concept #

Flint UI widgets are class-based, composable, and type-safe, similar to Flutter widgets — but designed for rendering to multiple formats (HTML, text, JSON).

final button = FlintButton(
  text: "Click Me",
  onClick: () => print("Button clicked!"),
  style: ButtonStyle(color: "#0066FF"),
);

This can render to:

<button style="background-color:#0066FF;">Click Me</button>

🧱 Widget Architecture #

Every Flint UI element extends FlintWidget, which defines multi-output rendering:

abstract class FlintWidget {
  String toHtml();
  String toText();
  Map<String, dynamic> toJson();
}

Flint UI currently includes:

🎨 Styling System #

Flint UI introduces style classes for full layout and visual control, mirroring Flutter's intuitive APIs.

🖼️ ImageStyle

const ImageStyle(
  opacity: 0.9,
  fit: ObjectFit.cover,
  filter: "grayscale(100%)",
  title: "Profile Picture",
);

➡️ Converts to:

opacity: 0.9;
object-fit: cover;
filter: grayscale(100%);

📦 BoxStyle

Includes BoxBorder, BorderRadius, BoxShadow, and BoxConstraints.

FlintContainer(
  style: BoxDecoration(
    gradient: Gradient.linear(
      stops: [
        ColorStop("#FF5733", 0.0),
        ColorStop("#FFC300", 1.0),
      ],
    ),
  ),
);

➡️ Generates:

background: linear-gradient(to bottom, #FF5733 0%, #FFC300 100%);

📄 Output Formats #

💡 Use Case Examples #

Email Templates

final email = FlintContainer(
  child: FlintColumn(children: [
    FlintText("Welcome to Flint!", style: TextStyle(fontSize: 24)),
    FlintButton(text: "Get Started", onClick: () {}),
  ]),
);

print(email.toHtml());

Server-Side Rendering (SSR)

Use Flint UI widgets to generate HTML views for your backend routes.

app.get('/welcome', (req, res) {
  final ui = FlintText("Welcome to Flint Server!");
  return res.html(ui.toHtml());
});

🧩 Database Enhancements #

Flint Dart’s ORM and schema engine continue to mature with smarter migration logic and framework-level introspection.

🕓 Auto–Managed Timestamp Columns #

Flint automatically injects created_at and updated_at columns into every table migration (if missing).

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  name VARCHAR(255),
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

✅ Supported on MySQL and PostgreSQL.

🔐 Auth Table Enhancements #

When the table matches your .env AUTH_TABLE (e.g. users), Flint automatically adds:

Example .env:

AUTH_TABLE=users
AUTH_PROVIDER_COLUMN=provider
AUTH_PROVIDER_ID_COLUMN=provider_id

💡 Non-auth tables skip these fields automatically.

📫 Mail System Upgrade #

🧠 Smarter Configuration via .env #

Flint’s Mail system now reads all SMTP credentials directly from .env.

MAIL_PROVIDER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=youremail@gmail.com
MAIL_PASSWORD=yourpassword
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=youremail@gmail.com
MAIL_FROM_NAME=Eulogia Technologies

⚙️ Automatic Setup #

Initialize with:

await MailConfig.load();

✅ Auto-detects provider ✅ Applies SSL/TLS ✅ Logs configuration status

Example output:

📧 Mail configured for provider: gmail (youremail@gmail.com)

🧰 Mail API Enhancements #

• .from() → Custom sender via .env
• .queue() → Background mail sending with isolates
• .sendMail() → Automatic plain-text fallback
• Unified configuration for all SMTP providers

Example:

await Mail()
  .to("user@example.com")
  .subject("Welcome to Flint Dart!")
  .html("<h1>Hello!</h1>")
  .sendMail();

🪶 Internal Framework Improvements #

• Fixed MySQL syntax for index creation (CREATE INDEX IF NOT EXISTS).
• Improved migration resilience for missing columns.
• Added consistent JSON serializers for all UI classes.
• Flint CLI updates for better hot reload and DB sync logging.
• Framework-level integration between Flint UI and Mail API for generating email bodies via widgets.

📚 Documentation Updates #

• Added Flint UI Developer Guide
• Added Flint Mail Setup & .env Reference
• Added Database Schema Enhancements section
• Added UI JSON Output specification for external integrations
• Updated Framework Change Log and migration system examples

Built with ❤️ by Eulogia Technologies Empowering Dart developers to build modern full-stack systems — backend + UI — all in Dart.

# 🚀 Flint Dart — Version 1.0.0+7

Flint Dart continues to evolve into a complete backend framework for Dart  modern tooling, and now a powerful real-time WebSocket system.
````markdown
# 🚀 Flint Dart — Version 1.0.0+6

Flint Dart continues to evolve into a complete backend framework for Dart developers — with Laravel-style syntax, modern tooling, and now a powerful real-time WebSocket system.




---

## 🧩 WebSocket System (Major Upgrade)

### 🔁 Socket.IO–like API
Flint now ships with an easy-to-use WebSocket engine with event-based communication:

```dart
app.ws('/chat', (socket, params) {
  socket.on('message', (data) {
    print('💬 ${socket.id} says: $data');
    socket.broadcastToRoom('chat', {'event': 'message', 'data': data});
  });
});

Client-side:

final ws = FlintWebSocketClient("wss://api.example.com/chat");
ws.on('message', (data) => print("📩 $data"));
ws.emit('message', {'text': 'Hello World'});

💬 Core Features #

• .emit(event, data) → Send named events easily
• .on(event, callback) → Listen for specific events
• .onMessage() and .onJsonMessage() remain supported for backward compatibility
• .join(room) and .leave(room) for group messaging
• .broadcast() and .broadcastToRoom() for real-time updates
• Auto Reconnect on the client when connection drops
• JWT Support using the same middleware chain as HTTP routes
• Auth Middleware can now protect both HTTP and WebSocket connections

🧠 Middleware Enhancements #

Middleware can now be used directly on WebSocket routes with the same .useMiddleware() API.

Example #

app.ws('/notifications', (socket, params) {
  socket.on('ping', (_) => socket.emit('pong', 'ok'));
}).useMiddleware(AuthMiddleware());

WebSocket Auth Example #

class AuthMiddleware extends Middleware {
  @override
  Handler handle(Handler next) {
    return (Request req, Response res) async {
      final token = req.bearerToken;
      if (token == null || token != "expected_token") {
        return res.status(401).send("Unauthorized");
      }
      return await next(req, res);
    };
  }
}

📫 Mail Integration #

WebSocket events can now trigger Flint's Mail API, enabling instant notification workflows (e.g., send an email when a user joins a chat).

socket.on('userJoined', (data) async {
  await Mail.to(data['email']).subject("Welcome!").send("Welcome to the chat!");
});

🧩 Developer Experience #

• Unified .emit() and .on() API across both server and client

• Auto-room management for group messages

• Cleaner connection logs:

  ✅ Client connected: <uuid>
  ❌ Client disconnected: <uuid>
  

• Consistent app.ws() route definition similar to app.get() and app.post()

🧰 CLI & Internal #

• Stability improvements for CLI and WebSocket debugging
• Hot reload-safe connections for development
• No new CLI commands introduced in this version

📚 Documentation #

• Added WebSocket Usage Guide:

  • Connecting with JWT
  • Using .emit() and .on()
  • Broadcasting
  • Room system

• Added Middleware for WebSockets section.

• Added example for mail integration within socket events.

• Updated Swagger documentation to include WebSocket annotations (experimental)

Built with ❤️ by Eulogia Technologies Empowering Dart developers to build modern, scalable backends.

---