ITADN

Refine the UX around the `project-create` and Advanced Options => Local Docker Setup stages

#898Openlasomethingsomething 创建于 2026-03-05
## Run-through and observations With version 0.12.1 Go here: https://developer.shopware.com/docs/products/cli/ to install (Homebrew) ### Step 1. shopware-cli project create <project> ### Step 2. Select version - picked "(latest)"/top - [ ] Want to go back from the patch versions to "latest" but can't - [ ] Decide where/how introduce this in devdocs: could start from within the CLI docs folder until we want to "go Hollywood." - We have this page https://developer.shopware.com/docs/products/cli/project-commands/helper-commands.html but my first guess was not to look there - [ ] CLI folder does not have an index.md; would create one, post `project create` info there - [ ] Confirm: Will we need, at any time, to give users the option to check/adjust Node or other reqts? => As a dev, I want to easily install **and adjust** all required prerequisites (such as Node.js, Docker, Composer, and PHP) so that I can set up my development environment quickly and start working without friction." ### Step 3. Select "Advanced Options" - chose "yes" - from options "None," "PaaS powered by Shopware", "PaaS powered by Platform.sh", "Deployer (SSH based zero-downtime) I chose "none" - [x] should be "SSH-based" **This time I didn't have Docker running. Got a FATAL error (exit status 1). Kicked me out of the workflow. I started over.** Saw "Installing dependencies" with little timer icon. Nice. But this really takes a while. <img width="296" height="78" alt="Image" src="https://github.com/user-attachments/assets/88e5aaf6-0cce-43c2-84c2-0bcf0fe81178" /> ### Step 4. "Select your CI/CD platform for automated testing and deployment" - from options "None," "GitHub Actions", and "GitLab CI" I chose "none" ### Step 5. Optional: Select additional features to enable - From options "Initialize Git Repository", "Local Docker Setup", "AMQP Queue Support", "Setup Elasticsearch/OpenSearch support" I picked the Local Docker Setup - Got this (nice) <img width="630" height="604" alt="Image" src="https://github.com/user-attachments/assets/8221be87-c8ac-44e5-bec7-ac217f54094c" /> - ran `cd louie && make up` and `docker compose up -d` appeared; I see containers, they're green/healthy - ran `make setup`; "Nothing to install, update or remove/Generating optimized autoload files" hangs a while - [x] spinny icon would be nice here ("is it stuck??") - in my terminal I see that I am now in my project, and I [go to the devdocs](https://developer.shopware.com/docs/guides/installation/start-developing.html) and use http://localhost:8000/admin#/login/ -- it worked! - [x] Would adjust to "Install Shopware with Local Docker Setup" so it's clear what I'm doing - [ ] maybe it should be the first option - [ ] At this stage (newcomer) I don't know why I would choose the other options; would need cues like how I adjusted Local Docker Setup - [x] ==> "Set up Elasticsearch" (Set up = verb, setup = noun); would also indicate "for large catalogues and/or advanced search" ### Step 6. Continue with "Start Developing" flow from DevDocs (sort of) - [x] fold the [devdocs step](https://developer.shopware.com/docs/guides/installation/start-developing.html) around accessing Admin and Storefront via http://localhost:8000/admin#/login/ and http://localhost:8000/ into the flow - [ ] resolve the issue with Storefront URL that takes me to error/"Sales Channel Not Found," caused by default setting in `.env.local` being `APP_ENV=prod` and not `APP_ENV=dev` - ran `make shell` - ran `bin/console` and got the long list of CLI commands - devdocs continue with Admin setup, and Install plugins or themes from the Store - [ ] I think this is the spot where we'll want to give folks a new round of options around "you have an empty project! Now A) create an extension (plugin=>plugin-based theme, y/no; or app); or then start working with APIs (drafting at https://github.com/shopware/docs/issues/2128#issuecomment-4004530923) **** #### From previous try/version Step 2. WARNING shopware/core (>=6.7) blah blah popped up and I had to choose from this menu: * `y` → Add Docker setup (recommended) * `n` → Skip Docker setup * `p` → Always add for this project * `x` → Never add for this project
7 条评论