https://github.com/fblettner/liberty-framework-template
Liberty Framework, next generation of no-code/low-code
https://github.com/fblettner/liberty-framework-template
fastapi liberty-core liberty-framework nomana-it python react
Last synced: 2 months ago
JSON representation
Liberty Framework, next generation of no-code/low-code
- Host: GitHub
- URL: https://github.com/fblettner/liberty-framework-template
- Owner: fblettner
- License: agpl-3.0
- Created: 2025-03-09T11:50:23.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-09T11:50:27.000Z (over 1 year ago)
- Last Synced: 2025-10-14T19:24:28.937Z (8 months ago)
- Topics: fastapi, liberty-core, liberty-framework, nomana-it, python, react
- Language: TypeScript
- Homepage: https://nomana-it.fr
- Size: 8.27 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📖 Liberty Framework Template
## 🚀 Overview
The **Liberty Framework** is a powerful, modular, and extensible framework built on **FastAPI (backend) and React (frontend)**. It is designed to accelerate business application development by providing:
- **Database Management** 📦 – Built-in database handling for seamless integrations.
- **Authentication & Security** 🔐 – Secure user authentication and authorization.
- **Real-Time Communication** 📡 – WebSocket support for live updates.
- **Scalability & Extensibility** ⚡ – Easily extend with custom services and modules.
This template provides a quick and structured way to start a new Liberty Framework project with **pre-configured backend and frontend components**.
---
## 🚀 Getting Started
You can set up a new Liberty Framework project in multiple ways:
### 🔹 Option 1: Clone the Repository (Manual Setup)
1. Clone this repository:
```sh
git clone https://github.com/fblettner/liberty-framework-template.git my-liberty-app
cd my-liberty-app
```
2. Run the installation script:
```sh
./install.sh # For macOS/Linux
install.bat # For Windows
```
3. Start the framework:
```sh
./start.sh # For macOS/Linux
start.bat # For Windows
```
### 🔹 Option 2: Use npm (Recommended)
1. Run the following command to create a new project interactively:
```sh
npm create myapps --template liberty-framework
```
2. Follow the prompts to set up your project.
3. Navigate to the project directory and start the framework:
```sh
cd my-liberty-app
./start.sh # macOS/Linux
start.bat # Windows
```
### 🔹 Option 3: Use npx (No Global Installation Required)
If you prefer not to install the package globally, use `npx`:
```sh
npx create-liberty-framework my-liberty-app
```
This will download and run the latest template without requiring a global installation.
---
## 📂 Project Structure
After installation, your project will have the following structure:
```
my-liberty-app/
├── app/ # FastAPI backend with API endpoints and database models
│ ├── main.py # Entry point for FastAPI
│ ├── routes/ # API routes
│ ├── models/ # Database models
├── frontend/ # React frontend using Liberty Core components
│ ├── src/
│ │ ├── components/ # UI components
│ │ ├── pages/ # Application pages
│ ├── public/ # Static assets
├── setup/ # Installation UI
│ ├── src/
│ │ ├── SetupWizard.tsx # UI for guided installation
├── install.sh # Setup script for Linux/macOS
├── install.bat # Setup script for Windows
├── start.sh # Start script for Linux/macOS
├── start.bat # Start script for Windows
```
---
## 🛠️ Requirements
To run Liberty Framework, ensure you have the following installed:
- **Python 3.12+** 🐍
- **Node.js 22+** 📦
- **npm or yarn** (for frontend dependencies)
To check if Python and Node.js are installed, run:
```sh
python3 --version
node --version
```
---
## 📌 Next Steps
- Read the **Liberty Framework Documentation** [https://docs.nomana-it.fr/liberty](https://docs.nomana-it.fr/liberty) 📚
- Explore the **example apps** [link to examples](https://docs.nomana-it.fr/liberty-core/) 🏗️
Happy coding! 🚀
---
## **License**
liberty-core is **open-source software** licensed under the **AGPL License**.
```
Copyright (c) 2025 NOMANA-IT and/or its affiliates.
All rights reserved. Use is subject to license terms.
```
---
## 📧 Contact & Support
If you have questions or need support:
- **Email**: [franck.blettner@nomana-it.fr](mailto:franck.blettner@nomana-it.fr)
- **GitHub Issues**: [Report an issue](https://github.com/fblettner/liberty-framework/issues)
- **Discussions**: Join the conversation in the **GitHub Discussions** section.
---
## 💖 Sponsorship
If you find **Liberty Core** useful and would like to support its development, consider sponsoring us. Your contributions help maintain the project, add new features, and improve the documentation. Every contribution, big or small, is greatly appreciated!
To sponsor, visit: **[GitHub Sponsors](https://github.com/sponsors/fblettner)** or reach out to us directly.
---