You can use an Example Gist as a complete starting model for a MDriven Turnkey site when you want to explore an application pattern and adapt it to your own domain.
An Example Gist is a reusable model and data starting point. It represents the system gist: the information the system handles and the business rules that govern it, kept distinct from technology choices and visual styling. For example, a project-planning gist can give you a starting structure for planning work; you then adapt its concepts, rules, and views to the process you want to support.
Choose the right kind of example
Use the example type that matches the work you want to do.
| If you want to... | Start here | Example |
|---|---|---|
| Apply a complete starting application to a Turnkey site | Use an Example Gist | Start with ProjectPlanning and adapt it into a planning application for your own clients. |
| Add a focused model section to an existing model | Use complete model examples | Add an example pattern to extend a model rather than replacing the model with a complete starting application. |
| Learn from a code-oriented example or a specific client technology | Use the relevant example page or training material | Review Code Snippet training when your goal is to understand a code snippet rather than start from a complete application model. |
Apply an Example Gist to a Turnkey site
Request a demo site through the MDriven portal, then apply one of the available samples to that site.
- Sign in to the MDriven portal at portal.mdriven.net.
- Request a demo site.
- On the demo site, select and apply an available sample.
- Review the resulting model, data, and application behavior before making changes.
- Fork the example and adapt it to your purpose. For example, change the concepts and rules in a project-planning sample to match the way your organization plans and follows up work.
- When the adapted application provides value, give your clients access to the system you have built.
The available samples can change. Treat the samples shown in your demo site as the current list.
Available Example Gists
The following examples have been provided as complete starting applications or sample applications:
- BaseApp â a model intended to include many features needed when onboarding users.
- Store complaint handling.
- Sudoku.
- Turnkey sample Board Map Balls Gantt.
- Turnkey sample InstantPoll.
- Turnkey sample SoftConflict.
- Turnkey sample ProjectPlanning.
- Google Map with Turnkey.
ProjectPlanning example
ProjectPlanning is a Generic Gist intended as a starting point for a different application. Use it to examine a small set of planning use cases, then fork and modify it for a specific business problem. The model and the resulting system are yours to evolve and provide to your clients.
Other examples
These examples cover other application styles and technologies. Use them for learning or as a starting point when they match the type of client application you are building.
- WPF MahappAndGantt.
- A Trello-like Board In MDrivenTurnkey.
- Rest Services In MDriven.
- MDriven In Xamarin.
- Barcode - on Android - with Xamarin and MDriven.
Work from the gist, not from the current technology
When you adapt an example, begin with the domain concepts and business rules that create value. Keep those concerns separate from modernity (technical infrastructure) and fashion (look and feel). For example, in a complaint-handling application, the complaint information and the rules for handling it belong to the gist; the selected client technology and visual design are separate concerns.
This separation makes the model easier to understand and evolve as business processes change. For background on this way of describing a system, see Praise to UML and What is not to like.