fix: remove useless entrypoint parameter from minimal application

Author: francescovallone

.website/.vitepress/config.mts

@@ -253,6 +253,7 @@ export default defineConfig({
             collapsed: true,
             items: [
               { text: 'Testing', link: 'testing' },
+              { text: 'Minimal Application', link: 'minimal_application' },
               // { text: 'Liquify', link: 'liquify' },
             ]
           },

.website/recipes/minimal_application.md

@@ -0,0 +1,79 @@
+# Minimal Application
+
+Serinus is optimal for building scalable and maintainable applications. However, sometimes you just need to drop down to the bare minimum and get things working as quickly as possible. This guide will show you how to create a minimal Serinus application with just a few lines of code.
+
+## Create a Minimal Application
+
+To create a minimal Serinus application, you can use the following code:
+
+```dart
+import 'package:serinus/serinus.dart';
+
+Future<void> main() async {
+    final application = await serinus.createMinimalApplication();
+    await application.serve();
+}
+```
+
+As you can see, we are using the `createMinimalApplication` method from the Serinus factory to create a new instance of the application. All the parameters are optional and will be set to default values if not provided.
+
+## Add some routes
+
+You can easily add routes to your minimal application using some application methods. Here's an example of how to add a simple route that returns a "Hello, World!" message:
+
+```dart
+import 'package:serinus/serinus.dart';
+
+Future<void> main() async {
+    final application = await serinus.createMinimalApplication();
+
+    application.get('/hello', (RequestContext context) async {
+        return 'Hello, World!';
+    });
+
+    await application.serve();
+}
+```
+
+In this example, we are adding a GET route at the path `/hello` that returns a simple string message. You can add as many routes as you need using the various HTTP methods provided by Serinus.
+
+## Add Middleware
+
+You can also add middleware to your minimal application to handle tasks such as logging, authentication, or request parsing. Here's an example of how to add a simple logging middleware:
+
+```dart
+import 'package:serinus/serinus.dart';
+
+Future<void> main() async {
+    final application = await serinus.createMinimalApplication();
+
+    application.useMiddleware(LogMiddleware());
+
+    application.get('/hello', (RequestContext context) async {
+        return 'Hello, World!';
+    });
+
+    await application.serve();
+}
+```
+
+The minimal application is a great way to quickly get started with Serinus and build simple applications without the need for complex configurations or setups. You can always add more features and functionality as your application grows.
+
+## All minimal application methods
+
+| Methods | Description |
+| --- | --- |
+| `get` | Creates a new GET route for the given path and handler. |
+| `post` | Creates a new POST route for the given path and handler. |
+| `put` | Creates a new PUT route for the given path and handler. |
+| `delete` | Creates a new DELETE route for the given path and handler. |
+| `patch` | Creates a new PATCH route for the given path and handler. |
+| `options` | Creates a new OPTIONS route for the given path and handler. |
+| `head` | Creates a new HEAD route for the given path and handler. |
+| `all` | Creates a new route for all HTTP methods for the given path and handler. |
+| `useMiddleware` | Adds a middleware to the application. |
+| `provide` | Provides a dependency to the application. |
+| `import` | Imports a module into the application. |
+| `serve` | Starts serving the application on the configured host and port. |
+
+All of these methods are available on the minimal application instance and can be used to build your application as needed. Also as you can see you can start by using the `provide` and `import` methods to set up your application's dependencies and modules, and when you app grows you can easily move these imports in your entrypoint module and use the `createApplication` method to create a more structured application.

packages/serinus/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.1.3
+
+**Released on:** 25-02-2026
+
+### Fixes
+
+- Remove useless `entrypoint` parameter from the `createMinimalApplication` method in the `SerinusFactory` class. This parameter is not needed for the creation of a minimal application and its presence can cause confusion for developers. Removing it simplifies the API and improves the developer experience when creating minimal applications with Serinus.
+
 ## 2.1.2
 
 **Released on:** 22-02-2026

packages/serinus/bin/serinus.dart

@@ -124,7 +124,6 @@ class MyModelProvider extends ModelProvider {
 
 void main(List<String> arguments) async {
   final application = await serinus.createMinimalApplication(
-    entrypoint: AppModule(),
     host: InternetAddress.anyIPv4.address,
     port: 3002,
     logger: ConsoleLogger(prefix: 'Serinus New Logger'),

packages/serinus/lib/src/core/factory.dart

@@ -81,7 +81,6 @@ final class SerinusFactory {
 
   /// The [createMinimalApplication] method is used to create a new instance of the [SerinusMinimalApplication] class.
   Future<SerinusMinimalApplication> createMinimalApplication({
-    required Module entrypoint,
     String host = 'localhost',
     int port = 3000,
     Set<LogLevel>? logLevels,

packages/serinus/pubspec.yaml

@@ -4,7 +4,7 @@ description: Serinus is a framework written in Dart
 documentation: https://serinus.app
 homepage: https://serinus.app
 repository: https://github.com/francescovallone/serinus
-version: 2.1.2
+version: 2.1.3
 funding:
   - https://github.com/sponsors/francescovallone
 topics:

packages/serinus/test/router/router_test.dart

@@ -125,7 +125,10 @@ void main() async {
         final result = router.lookup('/posts/123/comments', HttpMethod.get);
         expect(result, isA<FoundRoute>());
         final found = result as FoundRoute<RouterEntry>;
-        expect(found.values.first.context.path, equals('/posts/:postId/comments'));
+        expect(
+          found.values.first.context.path,
+          equals('/posts/:postId/comments'),
+        );
         expect(found.params['postId'], equals('123'));
       },
     );