Chat with this documentation in the Yada Framework Manual custom GPT. Beware of hallucinations!

General Principles

The Yada Framework is a collection of libraries, patterns, tools, code snippets and best practices to speed up web site development. The main focus is on productivity and the approach is to use proven and known technologies in a repeatable way, so that each new project is easier to develop and maintain. Another goal is simplicity as defined by the KISS principle: some technology that is very powerful and exciting and complicated to use, won’t find a place here.

The technology stack is as follows:

Tools used:

It is our strong belief that productivity is increased when using old and proven technologies (less bugs, less chance of deprecation, more documentation, more tools, more developer experience), and that simple architectures can efficiently solve most practical problems a developer will ever have to face.

Documentation Chapters

The documentation is a mix of tutorial and reference. The tutorial loosely follows the official Java "Duke’s Bookstore Case Study Example" with many improvements in functionality.

The tutorial sections are shown using this visual style.

What follows is a partial list of chapters with a brief explanation. The most updated index is in the dropdown at the top of each page.

Getting Started

This section will guide you through the setup of the development environment: installing Java, git, MySQL, Eclipse. It will then show you how to create an Eclipse project with a database and a web server

Bookstore Tutorial

When your development environment has been set by following the instructions in the previous chapter, you can start this tutorial that will show you how to quickly create a web application

i18n

Implement a multilanguage site

Databases

Storing and retrieving data

Forms

Submitting data to the server

Ajax

Easy async operations

Ajax Modals

Open a modal as a result of an ajax call

Security

User accounts and protecting pages behind login

DataTables

Effective handling of tabular data

Sending Emails

Templating applied to emails

Confirmation Modal

Easily ask for confirmation

Notification Modal

Quick messages to the user

Miscellaneous

Other features

Troubleshooting

Some hints for fixing problems

Upgrade Yada Framework Version

New versions are announced on this page, together with instructions on how to migrate from the previous one

Current Status

The Yada Framework will always be a work in progress: open source libraries will evolve, our ways of using them will improve, the Yada code will get smarter, best practices will change, bugs will be fixed…​ and documentation will always lag behind.

The master branch in the git repository contains the latest "unstable" development. Each new stable version will have its own branch on which non-disruptive changes will be committed. Users, when starting the development of a new project, should pick the latest version on a branch and stick to it. Every new version might have breaking changes so you should upgrade only when you know you can afford the time of fixing your code.

A step-by-step guide on how to migrate from a version to the next will be provided here.