Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding readme.md to loco-new #1076

Merged
merged 1 commit into from
Dec 12, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions loco-new/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ description = "Loco new app generator"
license = "Apache-2.0"
homepage = "https://docs.rs/loco"
documentation = "https://docs.rs/loco"
readme = "README.md"
authors = ["Dotan Nahum <[email protected]>", "Elad Kaplan <[email protected]>"]
include = ["src/**", "base_template/**", "Cargo.toml", "setup.rhai"]

Expand Down
37 changes: 37 additions & 0 deletions loco-new/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Loco CLI

Loco is a powerful framework designed to streamline the development of modern web applications with a focus on ease of use and flexibility. Whether you're building a SaaS app, a REST API, or a minimal service, Loco provides the tools you need to get started quickly and scale as your application grows. With built-in configuration for popular databases, background workers, and asset serving options, Loco gives you the power to customize your project to fit your needs.

## Templates Versatile Options
Loco empowers you to tailor your project to fit a variety of needs. Here are some of the versatile options it offers:

### Application Types
* **SaaS Applications:** Create platforms with features like user authentication, database integration, and scalable background processing.
* **REST APIs:** Build robust APIs with database support, authentication, and modular controllers.
* **Lightweight** Services: Focus on simplicity with minimal setups that include only essential controllers and views.

#### Advanced Customization
Loco is designed to offer advanced customization to meet the unique needs of your project. Whether you need a simple app that can evolve over time or a complex application that requires a specific configuration, Loco provides the flexibility to fine-tune your setup.


## Getting Started

To install the Loco CLI on your machine, simply run the following command in your terminal:
```sh
cargo install loco
```
This will install the latest version of Loco globally, making it accessible from anywhere in your terminal.

## Create a New Project:
Once installed, you can create a new Loco project by running the following command:
```sh
loco new
```
This will initiate a wizard that will guide you through the process of setting up your project.

## Upgrade
The Loco CLI is bundled with the Loco framework create version. To ensure you're using the latest version of Loco and to get the most up-to-date templates, simply run the following command:
```sh
cargo install loco
```
This will update the Loco CLI to the latest version, replacing the existing loco binary with the newest release. After upgrading, any new templates you generate will reflect the latest features and improvements.
Loading