DEV Community: Franck Blettner

A Generic Backend for All Your Apps

Franck Blettner — Thu, 27 Feb 2025 10:34:28 +0000

In modern application development, having a reusable and scalable backend is crucial for efficiency and maintainability. With the Liberty Framework, you can create a backend that serves multiple applications seamlessly. This guide will walk you through setting up your backend and integrating it with your frontend.

Step 1: Install the Framework

You can install the Liberty Framework using either Python or Docker, depending on your preference.

Requirements

A PostgreSQL 16 database is required. You can either:

Create a Docker image based on postgres:16, or
Install PostgreSQL 16 directly on your host system.

Install with Python

pip install liberty-framework

After installation, you can start the framework with:

liberty-start

Install with Docker

docker pull ghcr.io/fblettner/liberty-framework:latest
docker run -p 8000:8000 ghcr.io/fblettner/liberty-framework

Installation URL

Setup: http://<your_host>:<your_port>/setup Follow the wizard to configure your backend

Step 2: Configure the framework

Application: http://<your_host>:<your_port>

Connect to liberty with admin account and password set during the installation

Create a New Application

Go to the Menu.
Navigate to Settings > Applications.
Click Create a New Application.
Fill in the necessary Properties.
Configure the Connection settings.
Use the UI to set your application theme

Create the Database

After saving the new application you can create the database repository using button Create Database

Create a User

Right click on the application and select Display Users
Create a new user with the required permissions.

Step 3: Configure your Backend

Disconnect and reconnect to the BACKEND.

Go to the Menu.
Click on Framework to display the development menus
Create a new applications as you did in the first step for your database (Database that contains your application data)

Set Up Queries

Now that your backend is configured, you can create database queries.

Go to the Menu.
Queries Builder
Create your queries

Create query is easy, you will describe your query, add method for SELECT, UPDATE, INSERT or DELETE depending on your database type, and set your SQL

That's it ! You are now able to use your query in your frontend or simply as an API call.

Step 4: Usage example

Encrypt your password

Endpoint: POST /api/fmw/encrypt

{
    "plain_text": "your_password"
}

Get a token for your API user / password

Endpoint: POST /api/auth/token?pool=backend&mode=session&type=database

{
  "user": "admin",
  "password": "return_from_encrypt_endpoint"
}

Call your query

Endpoint: GET /api/db/query?source=query&type=table&pool=backend&mode=session&query=query_id

{
    "items": [
        {
            "ROW_ID": 1,
            "USR_APPS_ID": 10,
            "USR_ID": "APPLEAD",
            "USR_NAME": "Financial/Distribution Company",
            "USR_REGISTRATION": "430788490",
            "USR_STATUS": null,
            "USR_DT_LOGIN": null,
            "USR_DT_CREATION": null,
            "USR_PRIVILEGED": "N",
            "USR_DT_REFRESH": "2025-02-27",
            "USR_UKID": 2
        },
        {
            "ROW_ID": 2,
            "USR_APPS_ID": 10,
            "USR_ID": "CRPCTL",
            "USR_NAME": null,
            "USR_REGISTRATION": null,
            "USR_STATUS": null,
            "USR_DT_LOGIN": null,
            "USR_DT_CREATION": null,
            "USR_PRIVILEGED": "N",
            "USR_DT_REFRESH": "2025-02-27",
            "USR_UKID": 2
        },
        {
            "ROW_ID": 3,
            "USR_APPS_ID": 10,
            "USR_ID": "CRPDTA",
            "USR_NAME": null,
            "USR_REGISTRATION": null,
            "USR_STATUS": null,
            "USR_DT_LOGIN": null,
            "USR_DT_CREATION": null,
            "USR_PRIVILEGED": "N",
            "USR_DT_REFRESH": "2025-02-27",
            "USR_UKID": 2
        }
    ],
    "status": "success",
    "metadata": [
        {
            "headerName": "ROW_ID",
            "field": "ROW_ID",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_APPS_ID",
            "field": "USR_APPS_ID",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_ID",
            "field": "USR_ID",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_NAME",
            "field": "USR_NAME",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_REGISTRATION",
            "field": "USR_REGISTRATION",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_STATUS",
            "field": "USR_STATUS",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_DT_LOGIN",
            "field": "USR_DT_LOGIN",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_DT_CREATION",
            "field": "USR_DT_CREATION",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_PRIVILEGED",
            "field": "USR_PRIVILEGED",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_DT_REFRESH",
            "field": "USR_DT_REFRESH",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        },
        {
            "headerName": "USR_UKID",
            "field": "USR_UKID",
            "type": "text",
            "operator": "like",
            "rules": null,
            "rules_values": null,
            "default": null
        }
    ],
    "hasMore": false,
    "limit": 1000,
    "offset": 0,
    "count": 3
}

The Added Value of Liberty Framework

The Liberty Framework provides a structured and scalable backend solution that simplifies application development. It allows you to create and manage applications, configure databases, and delivers API endpoints for all your queries. The flexibility of Liberty Framework enables seamless integration with any frontend, whether you choose to use Liberty-Core or any other custom application. Its API-first approach ensures that your backend remains reusable, scalable, and adaptable to various use cases, making it an excellent choice for modern application development.

Instead of hardcoding your queries, you can manage them through a database with authentication and JWT security to prevent SQL injection.

Edit:
A socket dashboard is also available to display current connection to the database

Useful Links

🔗 GitHub Repository (Framework): Liberty Framework
📖 API Documentation: Liberty API Docs
🔗 GitHub Repository (Core): Liberty Core
🔗 GitHub Repository (Test Project): Liberty Test
📖 Live Documentation: Liberty Core Docs
💖 Sponsor & Support: Sponsor Liberty Core

Introducing Liberty Core – A Complete React Library !

Franck Blettner — Thu, 20 Feb 2025 10:32:55 +0000

Hello everyone! I’m excited to share Liberty Core, a React-based library designed not just as a component library, but as a full-featured framework for building modern, responsive web applications.

🔗 Documentation: https://docs.nomana-it.fr/liberty-core/
🔗 GitHub Repository: https://github.com/fblettner/liberty-core

🌟 Why Liberty Core?

Liberty Core provides everything you need to develop scalable applications, including:
✅ Authentication & OIDC integration
✅ Logging with Sentry
✅ WebSocket & real-time event management
✅ Highly customizable UI components
✅ Overridable API functions (Work in progress – customize without relying on the backend API)

The best part? The documentation itself is built using Liberty Core! 📖

💡 This is an open-source project, and contributions are always welcome! If you’re interested in extending, forking, or collaborating, check out the repository.

⚡ If you find value in this project and want to support its development, you can also sponsor the work:
🔗 Sponsorship: https://github.com/sponsors/fblettner

Would love to hear your feedback! 🚀🔥

Introducing Liberty Framework: A React/FastAPI Low-Code Platform for Enterprise Applications

Franck Blettner — Mon, 10 Feb 2025 18:58:01 +0000

🔹 Liberty Framework is an open-source No-Code/Low-Code framework built with React and FastAPI, designed to help businesses and developers rapidly create enterprise applications.

Whether you’re a developer looking to accelerate your workflow or a business user needing custom applications without coding, Liberty Framework provides the flexibility to create powerful, scalable, and AI-driven applications with minimal effort.

🛠️ What is Liberty Framework?

Liberty Framework is a fully modular platform designed to:

✅ Enable No-Code/Low-Code Development – Build applications visually without extensive programming.
✅ Provide Enterprise-Grade Scalability – Works for both startups and large-scale businesses.
✅ Integrate AI and Automation – Use OpenAI-powered AI and workflow automation with Airflow.
✅ Offer Flexibility – Customize, extend, and integrate with your existing systems.
✅ Simplify Deployment – Containerized with Docker for easy deployment anywhere.
✅ Monitoring – Integrated with Sentry and Grafana to monitor errors and performance
✅ Components – Custom components written in React to remove any external dependencies like MUI or AG-Grid

💡 Liberty Framework is built to bridge the gap between visual programming and developer-friendly customization.

🌟 No-Code & Low-Code Capabilities

With Liberty Framework, business users can create applications while developers can extend functionality using React components and FastAPI services.

🔹 Visual UI Designer – Build user interfaces without writing code.
🔹 Workflow Automation – Define processes and logic visually.
🔹 Custom Components – Developers can integrate custom-built React components.

🧠 AI & OpenAI Integration

Liberty Framework comes with built-in AI support, allowing you to:
✅ Generate text using GPT models
✅ Create AI-powered chatbots
✅ Automate responses & decision-making

📊 Enterprise Workflow Automation

Liberty integrates with Apache Airflow, enabling you to:
🔹 Define and schedule business processes
🔹 Automate repetitive tasks
🔹 Monitor & orchestrate workflows

⚡ API-Driven & Extensible

Liberty Framework is fully API-driven, allowing seamless integration with external systems:
✅ REST APIs
✅ Custom backend logic with FastAPI
✅ Third-party service integrations (e.g., databases, authentication, analytics)

💻 Why Liberty Framework?

🔹 For Business Users – Build applications without writing code.
🔹 For Developers – Extend, customize, and integrate as needed.
🔹 For Enterprises – Automate workflows, manage AI-driven tasks, and scale effortlessly.

Unlike traditional no-code tools, Liberty provides a developer-friendly environment while keeping the power of visual programming accessible to all users.

💰 Sponsorship & Support

Liberty Framework is open-source and licensed under AGPL. If your company benefits from Liberty, consider supporting development through sponsorship:

🔹 GitHub Sponsors
🔹 Enterprise Support & Consulting – Contact us for dedicated assistance.

Your support helps keep Liberty free and continuously improving!

🚀 Join the Community

⭐ Star Liberty Framework on GitHub
📢 Follow updates on LinkedIn
💬 Open an issue or contribute to the project

Liberty Framework is built for the future – try it today and shape the future of No-Code/Low-Code development! 🎉

Demo available at : https://liberty.nomana-it.fr