{"title":"New","description":"","section":"cli","version":"v1.5","path":"cli/new","canonical_url":"https://amberframework.org/docs/v1.5/cli/new","markdown_url":"https://amberframework.org/docs/v1.5/cli/new.md","inherited":true,"content_markdown":"# New\n\n## `amber new`\n\nThis is the first command that you will run when generating a new Amber application. It creates a new Amber application with a default directory structure and configuration setting at the path you specify.\n\nAn `.amber.yml` configuration file is generated a long with the default application directory structure. This stores some metadata for the Amber CLI to make use of for generating migrations, scaffolding templates, and more.\n\n```text\namber new [OPTIONS] NAME\n\nGenerates a new Amber project\n\nArguments:\n  NAME  name/path of project\n\nOptions:\n  -d                Select the database database engine, can be one of: pg | mysql | sqlite\n                    (default: pg)\n  --minimal         Does not install npm dependencies\n  --no-color        Disable colored output\n  --no-deps         Does not install dependencies, this avoids running shards update\n  -r                Use a named recipe.  See documentation at  https://docs.amberframework.org/amber/cli/recipes.\n  -t                Selects the template engine language, can be one of: slang | ecr\n                    (default: slang)\n  -y, --assume-yes  Assume yes to disable interactive mode\n  -h, --help        show this help\n```\n\nSee the **Recipes** option of the **Command Line Tool** for information about using recipes to generate applications.\n\n### Example Usage\n\nUsing `amber new microsecond-blog` will generate a skeleton Amber application in `./microsecond-blog`. You can have a running web application in a matter of minutes:\n\n```text\namber new microsecond-blog -d sqlite\ncd microsecond-blog\namber watch\nopen http://localhost:3000\n```\n\nFull example in terminal:\n\n```text\n$ amber new microsecond-blog\nRendering App microsecond-blog in ./microsecond-blog\nnew       .amber.yml\nnew       .amber_secret_key\nnew       .gitignore\nnew       .travis.yml\nnew       config/application.cr\nnew       config/database.yml\n... [clipped]\nnew       src/views/layouts/_nav.slang\nnew       src/views/layouts/application.slang\nnew       src/microsecond-blog.cr\n$ cd microsecond-blog/\n$ shards install\nUpdating https://github.com/amberframework/amber.git\nUpdating https://github.com/luislavena/radix.git\n... [clipped]\nInstalling garnet_spec (0.1.1)\n$ amber watch        \n02:58:23 Watcher    | (INFO) Watching 22 files (server reload)...\n02:58:23 Watcher    | (INFO) Building project microsecond-blog...\n02:58:31 Watcher    | (INFO) Terminating app microsecond-blog...\n02:58:31 Watcher    | (INFO) Starting microsecond-blog...\n02:58:31 Server     | (INFO) Amber 0.7.2 serving application \"microsecond-blog\" at http://0.0.0.0:3000\n02:58:31 Server     | (INFO) Server started in development.\n02:58:31 Server     | (INFO) Startup Time 00:00:00.000182000\n02:58:31 Watcher    | Watching 10 client files...\n```"}