Aurelia 2 Quick Try

# Quick Install Guide Get Aurelia up and running in 5 minutes or less. ## Prerequisites * [Node.js](https://nodejs.org/en/) (latest version recommended) * A code editor of your choice ## Option 1: Try Aurelia Instantly (No Setup Required) Want to try Aurelia immediately? Copy this into an HTML file and open it in your browser: ```html Aurelia 2 Quick Try

``` {% hint style="info" %} **No installation required!** This uses Aurelia directly from a CDN. Perfect for experimentation or simple projects. For a more complete example, see the [realworld-vanilla example](https://github.com/aurelia/aurelia/tree/master/examples/realworld-vanilla) which demonstrates a full application with routing. {% endhint %} ## Option 2: Create Your App Aurelia uses the [Makes](https://www.npmjs.com/package/makes) scaffolding tool. No global installs required. ```bash npx makes aurelia ``` When prompted: * **Project name**: Enter your project name * **Setup**: Choose TypeScript (recommended) or ESNext * **Install dependencies**: Select "Yes" {% hint style="info" %} **Why TypeScript?** Get intellisense, type safety, and better tooling support out of the box. {% endhint %} ### Run Your App Navigate to your project and start the development server: ```bash cd your-project-name npm start ``` Your browser will automatically open to `http://localhost:8080` showing your new Aurelia app. ## Verify Everything Works You should see "Hello World!" displayed in your browser. The development server watches for changes and auto-reloads. ## What's Next? * **New to Aurelia?** Try our [Hello World Tutorial](https://docs.aurelia.io/getting-started/quick-start-guide) for a hands-on introduction * **Ready for more?** Explore our [developer guides](https://github.com/aurelia/aurelia/blob/master/docs/user-docs/developer-guides/README.md) and [tutorials](https://github.com/aurelia/aurelia/blob/master/docs/user-docs/tutorials/README.md) * **Need help?** Check out [troubleshooting](https://docs.aurelia.io/developer-guides/debugging-and-troubleshooting) ## Recommended Reading Want deeper context after the quick start? These guides build on the concepts introduced here: * **Component basics** – Understand how views and view-models pair up plus when to use imports vs. global registration in [Component essentials](https://docs.aurelia.io/introduction/essentials/components). * **Project structure & conventions** – See how the scaffolded files fit together in the [Complete guide's project structure section](https://docs.aurelia.io/complete-guide#step-2-project-structure). * **Template syntax & binding** – Explore binding commands, loops, and conditionals in the [template syntax overview](https://docs.aurelia.io/templates/overview). * **Dependency injection** – Learn how Aurelia's DI container works and when to call `resolve()` in the [DI overview](https://docs.aurelia.io/getting-to-know-aurelia/services-and-runtime-hooks/dependency-injection/overview). * **Routing** – When you need multiple pages, follow the [router getting started guide](https://docs.aurelia.io/getting-to-know-aurelia/aurelia-router/fundamentals/getting-started) to add navigation. ## Core Concepts (Optional Reading) Aurelia is built on familiar web technologies with a few key concepts: * **Components**: Made of view-models (`.ts`/`.js`) and views (`.html`) * **Conventions**: File names and structure follow predictable patterns * **Dependency Injection**: Built-in system for managing services and dependencies * **Enhanced HTML**: Templates use familiar HTML with powerful binding syntax These concepts become clearer as you build with Aurelia. Start with the tutorial above to see them in action!