fix: pages path for src: yes errors on startup, add recommended extensions

Author: reecelikesramen

README.md

@@ -2,12 +2,28 @@
 
 Quick start wizard for new pywire projects.
 
-## Usage
+<!-- INSTALL_MESSAGE_TEMPLATE_START -->
+## 🚀 Quick Start
+
+If you already have [uv](https://docs.astral.sh/uv/) installed, you can get started instantly:
 
 ```bash
 uvx create-pywire-app
 ```
 
+If you don't have `uv` installed or aren't sure, use our installer script which handles the setup for you:
+
+### macOS / Linux
+```bash
+curl -fsSL pywire.dev/install | sh
+```
+
+### Windows (PowerShell)
+```powershell
+irm pywire.dev/install.ps1 | iex
+```
+<!-- INSTALL_MESSAGE_TEMPLATE_END -->
+
 <!-- SUPPORT_MESSAGE_TEMPLATE_START -->
 ## ❤️ Support pywire
 

src/create_pywire_app/main.py

@@ -113,6 +113,7 @@ def generate(self) -> None:
         self._generate_gitignore()
         self._generate_main()
         self._generate_error_page()
+        self._generate_vscode_settings()
 
         # Generate template-specific files
         if self.template == "counter":
@@ -150,10 +151,19 @@ def _generate_gitignore(self) -> None:
         """Generate .gitignore."""
         self.renderer.copy_static("common/.gitignore", self.project_path / ".gitignore")
 
+    def _generate_vscode_settings(self) -> None:
+        """Generate VS Code settings."""
+        vscode_dir = self.project_path / ".vscode"
+        vscode_dir.mkdir(exist_ok=True)
+        self.renderer.copy_static("common/extensions.json", vscode_dir / "extensions.json")
+
     def _generate_main(self) -> None:
         """Generate main.py."""
         template_name = "main-path.py.j2" if self.routing_strategy == "path" else "main-explicit.py.j2"
-        content = self.renderer.render(f"common/{template_name}", {})
+        context = {
+            "pages_dir": "src/pages" if self.use_src else "pages",
+        }
+        content = self.renderer.render(f"common/{template_name}", context)
         (self.app_root / "main.py").write_text(content)
 
     def _generate_error_page(self) -> None:
@@ -396,6 +406,8 @@ def main():
 Run the following commands to enter the environment:
 
     {cmd_text}
+
+> **Tip:** Install the **PyWire** extension (id: `pywire.pywire`) in VS Code for syntax highlighting and snippets.
             """
                 ),
                 border_style="cyan",

src/create_pywire_app/templates/common/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations": [
+    "pywire.pywire"
+  ]
+}

src/create_pywire_app/templates/common/main-explicit.py.j2

@@ -3,7 +3,7 @@ from pywire import PyWire
 # Create application instance
 app = PyWire(
     path_based_routing=False,
-    pages_dir="pages",
+    pages_dir="{{ pages_dir }}",
     enable_pjax=True,
     debug=True,
 )

src/create_pywire_app/templates/common/main-path.py.j2

@@ -2,7 +2,7 @@ from pywire import PyWire
 
 # Create application instance
 app = PyWire(
-    pages_dir="pages",
+    pages_dir="{{ pages_dir }}",
     enable_pjax=True,
     debug=True,
 )