{"id":26571756,"url":"https://github.com/fblettner/liberty-framework-template","last_synced_at":"2026-04-17T17:32:42.752Z","repository":{"id":282566343,"uuid":"945425214","full_name":"fblettner/liberty-framework-template","owner":"fblettner","description":"Liberty Framework, next generation of no-code/low-code","archived":false,"fork":false,"pushed_at":"2025-03-09T11:50:27.000Z","size":8667,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-14T19:24:28.937Z","etag":null,"topics":["fastapi","liberty-core","liberty-framework","nomana-it","python","react"],"latest_commit_sha":null,"homepage":"https://nomana-it.fr","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fblettner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-09T11:50:23.000Z","updated_at":"2025-03-09T11:51:51.000Z","dependencies_parsed_at":"2025-03-15T14:17:21.168Z","dependency_job_id":null,"html_url":"https://github.com/fblettner/liberty-framework-template","commit_stats":null,"previous_names":["fblettner/liberty-framework-template"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fblettner/liberty-framework-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fblettner%2Fliberty-framework-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fblettner%2Fliberty-framework-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fblettner%2Fliberty-framework-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fblettner%2Fliberty-framework-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fblettner","download_url":"https://codeload.github.com/fblettner/liberty-framework-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fblettner%2Fliberty-framework-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31938753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","liberty-core","liberty-framework","nomana-it","python","react"],"created_at":"2025-03-22T23:16:03.110Z","updated_at":"2026-04-17T17:32:42.735Z","avatar_url":"https://github.com/fblettner.png","language":"TypeScript","funding_links":["https://github.com/sponsors/fblettner"],"categories":[],"sub_categories":[],"readme":"# 📖 Liberty Framework Template\n\n## 🚀 Overview\n\nThe **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:\n\n- **Database Management** 📦 – Built-in database handling for seamless integrations.\n- **Authentication \u0026 Security** 🔐 – Secure user authentication and authorization.\n- **Real-Time Communication** 📡 – WebSocket support for live updates.\n- **Scalability \u0026 Extensibility** ⚡ – Easily extend with custom services and modules.\n\nThis template provides a quick and structured way to start a new Liberty Framework project with **pre-configured backend and frontend components**.\n\n---\n\n## 🚀 Getting Started\n\nYou can set up a new Liberty Framework project in multiple ways:\n\n### 🔹 Option 1: Clone the Repository (Manual Setup)\n1. Clone this repository:\n   ```sh\n   git clone https://github.com/fblettner/liberty-framework-template.git my-liberty-app\n   cd my-liberty-app\n   ```\n2. Run the installation script:\n   ```sh\n   ./install.sh  # For macOS/Linux\n   install.bat   # For Windows\n   ```\n3. Start the framework:\n   ```sh\n   ./start.sh    # For macOS/Linux\n   start.bat     # For Windows\n   ```\n\n### 🔹 Option 2: Use npm (Recommended)\n1. Run the following command to create a new project interactively:\n   ```sh\n   npm create myapps --template liberty-framework\n   ```\n2. Follow the prompts to set up your project.\n3. Navigate to the project directory and start the framework:\n   ```sh\n   cd my-liberty-app\n   ./start.sh    # macOS/Linux\n   start.bat     # Windows\n   ```\n\n### 🔹 Option 3: Use npx (No Global Installation Required)\nIf you prefer not to install the package globally, use `npx`:\n```sh\nnpx create-liberty-framework my-liberty-app\n```\nThis will download and run the latest template without requiring a global installation.\n\n---\n\n## 📂 Project Structure\n\nAfter installation, your project will have the following structure:\n\n```\nmy-liberty-app/\n├── app/        # FastAPI backend with API endpoints and database models\n│   ├── main.py     # Entry point for FastAPI\n│   ├── routes/     # API routes\n│   ├── models/     # Database models\n├── frontend/       # React frontend using Liberty Core components\n│   ├── src/\n│   │   ├── components/ # UI components\n│   │   ├── pages/      # Application pages\n│   ├── public/       # Static assets\n├── setup/          # Installation UI\n│   ├── src/\n│   │   ├── SetupWizard.tsx  # UI for guided installation\n├── install.sh      # Setup script for Linux/macOS\n├── install.bat     # Setup script for Windows\n├── start.sh        # Start script for Linux/macOS\n├── start.bat       # Start script for Windows\n```\n\n---\n\n## 🛠️ Requirements\nTo run Liberty Framework, ensure you have the following installed:\n\n- **Python 3.12+** 🐍\n- **Node.js 22+** 📦\n- **npm or yarn** (for frontend dependencies)\n\nTo check if Python and Node.js are installed, run:\n```sh\npython3 --version\nnode --version\n```\n\n---\n\n## 📌 Next Steps\n- Read the **Liberty Framework Documentation** [https://docs.nomana-it.fr/liberty](https://docs.nomana-it.fr/liberty) 📚\n- Explore the **example apps** [link to examples](https://docs.nomana-it.fr/liberty-core/) 🏗️\n\nHappy coding! 🚀\n\n---\n\n## **License**\nliberty-core is **open-source software** licensed under the **AGPL License**.  \n```\nCopyright (c) 2025 NOMANA-IT and/or its affiliates.\nAll rights reserved. Use is subject to license terms.\n```\n\n---\n\n## 📧 Contact \u0026 Support  \nIf you have questions or need support:  \n- **Email**: [franck.blettner@nomana-it.fr](mailto:franck.blettner@nomana-it.fr)  \n- **GitHub Issues**: [Report an issue](https://github.com/fblettner/liberty-framework/issues)  \n- **Discussions**: Join the conversation in the **GitHub Discussions** section.  \n\n---\n\n## 💖 Sponsorship  \nIf 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!  \n\nTo sponsor, visit: **[GitHub Sponsors](https://github.com/sponsors/fblettner)** or reach out to us directly.  \n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffblettner%2Fliberty-framework-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffblettner%2Fliberty-framework-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffblettner%2Fliberty-framework-template/lists"}