turutupa / cf-create-app

14 stars 3 forks source link

Header Image

cf-create-app

Explore the docs »

Report Bug | Request Feature


Table of Contents

About The Project

This project is meant to simplify the initial configuration needed to create and deploy an end-to-end application to a Cloud Foundry account in SAP Cloud Platform.

What cf-create-app does for you?

  1. Creates a basic CAP application
  2. Adds a simple React, Angular or Vue application to your project
  3. Adds an HTML5 Deployer to the project
  4. Adds an Application Router to the project
  5. Adds the HTML5 Application Repository service (app-host and app-runtime) to the project
  6. Adds the Authentication and Authorization service (XSUAA) to the project
  7. Bind all modules together as a MTA application, ready to be deployed in a Cloud Foundry environment

Built With

cf-create-app uses the following technologies and frameworks:

Getting Started

Setting and end-to-end application in SAP Cloud Platform is not a trivial task.

This tool creates a project with all the components you need to build (and easily deploy) a web application with a CAP backend exposing OData services, and an HTML5 application ready to consume those services.

Prerequisites

Pre-requisite Description Documentation
Node.js v12 Required runtime for this boilerplate. Recommended install it with NVM Download
cf cli Cloud Foundy CLI tool Download

Cloud prerequisites

To be able to deploy this application you need an SAP Cloud Platform account in the Cloud Foundry (CF) environment.

In your CF account space, the following services must be available:

Recommended tools

Tools Description Documentation
VS Code CDS extension VS Code extension with code complete and other tools for CDS development Download
MTA Plugin for CF CLI Plugin to add useful commands to manage MTA applications using CF CLI Download
HTML5 Applications Repository CF CLI Plugin Plugin to add useful commands to manage HTML5 Application Repository apps using CF CLI Download

Usage

Create your app

Open a terminal in your workspace directory and run:

npx cf-create-app YOUR_APP_NAME

In the comand prompt, choose the frontend framework you prefer:

UI framework command prompt

In the comand prompt, choose the frontend framework you prefer:

UI framework command prompt

The new project contains these folders and files, following the recommended project layout:

File / Folder Purpose
app/ content for UI frontends go here
approuter/ Application Router configuration files
db/ your domain models and data go here
html5Deployer/ helper application to deploy HTML5 apps to the HTML5 Application Repository service in SAP Cloud Platform
srv/ your service models and code go here
package.json project metadata and configuration
README.md this getting started guide

Add your business logic

Deploy the app

Open a terminal in the project root directory and run:

mbt build
cf deploy mta_archives/yourAppMtarArchiveName.mtar

Next steps

HOW TO: Run and develop your app in localhost

Learn more about localhost development on: Localhost Development

HOW TO: Create this boilerplate manually step-by-step

Learn more about manual configuration on: Manual Configuration

Roadmap

These are some of our backlog items

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License.

Contact

Project Link: https://github.com/Turutupa/cf-create-app

Acknowledgements