@minnai/create-aura-app 0.0.2

package/dist/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const prompts_1 = __importDefault(require("prompts"));
+const colors_1 = require("kleur/colors");
+const path_1 = __importDefault(require("path"));
+const scaffold_1 = require("./scaffold");
+const program = new commander_1.Command();
+let PROJECT_DIR = '';
+program
+    .name('create-aura-app')
+    .description('Scaffold a new Aura application')
+    .arguments('[project-directory]')
+    .action((dir) => {
+    PROJECT_DIR = dir;
+})
+    .parse(process.argv);
+async function main() {
+    console.log((0, colors_1.bold)((0, colors_1.blue)('\n✨ Welcome to Aura! Let\'s create your new app.\n')));
+    let targetDir = PROJECT_DIR;
+    if (!targetDir) {
+        const response = await (0, prompts_1.default)({
+            type: 'text',
+            name: 'value',
+            message: 'Where should we create your project?',
+            initial: 'aura-app'
+        });
+        targetDir = response.value;
+    }
+    if (!targetDir) {
+        console.log((0, colors_1.red)('✖ Operation cancelled'));
+        process.exit(1);
+    }
+    const questions = [
+        {
+            type: 'select',
+            name: 'template',
+            message: 'Which template would you like to use?',
+            choices: [
+                { title: 'Starter (Recommended)', description: 'Full chat app with Zero-Config Free Tier Proxy', value: 'starter' },
+                { title: 'Blank', description: 'Minimal setup for custom development', value: 'blank' }
+            ],
+            initial: 0
+        },
+        {
+            type: 'select',
+            name: 'language',
+            message: 'Which language would you like to use?',
+            choices: [
+                { title: 'TypeScript', description: 'Recommended for robustness', value: 'typescript' },
+                { title: 'JavaScript', description: 'Standard JS', value: 'javascript' }
+            ],
+            initial: 0
+        },
+        {
+            type: 'confirm',
+            name: 'install',
+            message: 'Install dependencies now?',
+            initial: true
+        },
+        {
+            type: 'confirm',
+            name: 'git',
+            message: 'Initialize a new git repository?',
+            initial: true
+        }
+    ];
+    const answers = await (0, prompts_1.default)(questions);
+    if (!answers.template) {
+        console.log((0, colors_1.red)('✖ Operation cancelled'));
+        process.exit(1);
+    }
+    const root = path_1.default.resolve(process.cwd(), targetDir);
+    const projectName = path_1.default.basename(root);
+    await (0, scaffold_1.scaffold)({
+        root,
+        projectName,
+        template: answers.template,
+        language: answers.language,
+        install: answers.install,
+        git: answers.git
+    });
+    console.log((0, colors_1.bold)((0, colors_1.green)('\n✔ Success! Created ' + projectName + ' at ' + root + '\n')));
+    console.log('Inside that directory, you can run several commands:\n');
+    console.log((0, colors_1.blue)(`  npm run dev`));
+    console.log('    Starts the development server.\n');
+    console.log((0, colors_1.blue)(`  npm run build`));
+    console.log('    Bundles the app for production.\n');
+    console.log('We suggest that you begin by typing:\n');
+    console.log((0, colors_1.blue)(`  cd ${targetDir}`));
+    if (!answers.install) {
+        console.log((0, colors_1.blue)(`  npm install`));
+    }
+    console.log((0, colors_1.blue)(`  npm run dev\n`));
+    if (answers.template === 'starter') {
+        console.log((0, colors_1.yellow)((0, colors_1.bold)('NOTE: The starter project is pre-configured with our Free Tier Proxy.')));
+        console.log((0, colors_1.yellow)('You can start chatting immediately without any API keys or login!\n'));
+        console.log((0, colors_1.yellow)((0, colors_1.bold)('Also, this starter has NO Auth/Login code included as per your request.')));
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/scaffold.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffold = scaffold;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const child_process_1 = require("child_process");
+const colors_1 = require("kleur/colors");
+async function scaffold(options) {
+    const { root, template, install, git, projectName } = options;
+    console.log((0, colors_1.dim)(`\nScaffolding project in ${root}...`));
+    // Determine template path
+    // Assumes templates are in ../templates relative to dist/index.js
+    const templateDir = path_1.default.resolve(__dirname, '..', 'templates', template);
+    if (!fs_extra_1.default.existsSync(templateDir)) {
+        throw new Error(`Template "${template}" not found at ${templateDir}`);
+    }
+    // Copy template files
+    await fs_extra_1.default.copy(templateDir, root, {
+        filter: (src) => {
+            // Filter out node_modules or other unnecessary files if they exist in templates
+            return !src.includes('node_modules');
+        }
+    });
+    // Rename _gitignore to .gitignore
+    const gitignorePath = path_1.default.join(root, '_gitignore');
+    if (fs_extra_1.default.existsSync(gitignorePath)) {
+        await fs_extra_1.default.move(gitignorePath, path_1.default.join(root, '.gitignore'));
+    }
+    // Update package.json name
+    const pkgPath = path_1.default.join(root, 'package.json');
+    if (fs_extra_1.default.existsSync(pkgPath)) {
+        const pkg = await fs_extra_1.default.readJson(pkgPath);
+        pkg.name = projectName;
+        await fs_extra_1.default.writeJson(pkgPath, pkg, { spaces: 2 });
+    }
+    // Initialize Git
+    if (git) {
+        try {
+            (0, child_process_1.execSync)('git init', { cwd: root, stdio: 'ignore' });
+            (0, child_process_1.execSync)('git add -A', { cwd: root, stdio: 'ignore' });
+            (0, child_process_1.execSync)('git commit -m "Initial commit from create-aura-app"', { cwd: root, stdio: 'ignore' });
+            console.log((0, colors_1.dim)('Initialized a git repository.'));
+        }
+        catch (e) {
+            console.warn((0, colors_1.dim)('Git initialization failed. Skipping...'));
+        }
+    }
+    // Install dependencies
+    if (install) {
+        console.log((0, colors_1.dim)('Installing dependencies... This might take a moment.'));
+        try {
+            (0, child_process_1.execSync)('npm install', { cwd: root, stdio: 'inherit' });
+        }
+        catch (e) {
+            console.warn((0, colors_1.dim)('Dependency installation failed. You may need to run npm install manually.'));
+        }
+    }
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+    "name": "@minnai/create-aura-app",
+    "version": "0.0.2",
+    "description": "Scaffolding tool for new Aura projects",
+    "bin": "dist/index.js",
+    "files": [
+        "dist",
+        "templates"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc -w",
+        "start": "node dist/index.js",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": [
+        "aura",
+        "scaffold",
+        "cli",
+        "create-aura-app"
+    ],
+    "author": "Minn.ai",
+    "license": "MIT",
+    "dependencies": {
+        "commander": "^13.1.0",
+        "prompts": "^2.4.2",
+        "kleur": "^4.1.5",
+        "fs-extra": "^11.3.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.13.0",
+        "@types/prompts": "^2.4.9",
+        "@types/fs-extra": "^11.0.4",
+        "typescript": "^5.7.3"
+    }
+}

package/templates/blank/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aura App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/blank/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "my-aura-app",
+    "private": true,
+    "version": "0.0.0",
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "tsc && vite build",
+        "preview": "vite preview"
+    },
+    "dependencies": {
+        "@minnai/aura": "latest",
+        "react": "^18.2.0",
+        "react-dom": "^18.2.0"
+    },
+    "devDependencies": {
+        "@types/react": "^18.2.66",
+        "@types/react-dom": "^18.2.22",
+        "@vitejs/plugin-react": "^4.2.1",
+        "typescript": "^5.2.2",
+        "vite": "^5.2.0"
+    }
+}

package/templates/blank/src/App.tsx

@@ -0,0 +1,21 @@
+import { useState } from 'react'
+
+function App() {
+    const [count, setCount] = useState(0)
+
+    return (
+        <div style={{ padding: '2rem', fontFamily: 'sans-serif' }}>
+            <h1>Vite + React + Aura</h1>
+            <div className="card">
+                <button onClick={() => setCount((count) => count + 1)}>
+                    count is {count}
+                </button>
+                <p>
+                    Edit <code>src/App.tsx</code> to start building your Aura app.
+                </p>
+            </div>
+        </div>
+    )
+}
+
+export default App

package/templates/blank/src/index.css

@@ -0,0 +1,40 @@
+:root {
+  font-family: Inter, system-ui, Avenir, Helvetica, Arial, sans-serif;
+  line-height: 1.5;
+  font-weight: 400;
+  color-scheme: light dark;
+  color: rgba(255, 255, 255, 0.87);
+  background-color: #242424;
+}
+
+body {
+  margin: 0;
+  display: flex;
+  place-items: center;
+  min-width: 320px;
+  min-height: 100vh;
+}
+
+h1 {
+  font-size: 3.2em;
+  line-height: 1.1;
+}
+
+button {
+  border-radius: 8px;
+  border: 1px solid transparent;
+  padding: 0.6em 1.2em;
+  font-size: 1em;
+  font-weight: 500;
+  font-family: inherit;
+  background-color: #1a1a1a;
+  cursor: pointer;
+  transition: border-color 0.25s;
+}
+button:hover {
+  border-color: #646cff;
+}
+button:focus,
+button:focus-visible {
+  outline: 4px auto -webkit-focus-ring-color;
+}

package/templates/blank/src/main.tsx

@@ -0,0 +1,10 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import App from './App'
+import './index.css'
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+    <React.StrictMode>
+        <App />
+    </React.StrictMode>,
+)

package/templates/blank/tsconfig.json

@@ -0,0 +1,31 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "useDefineForClassFields": true,
+        "lib": [
+            "ES2020",
+            "DOM",
+            "DOM.Iterable"
+        ],
+        "module": "ESNext",
+        "skipLibCheck": true,
+        "moduleResolution": "bundler",
+        "allowImportingTsExtensions": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true,
+        "noEmit": true,
+        "jsx": "react-jsx",
+        "strict": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true
+    },
+    "include": [
+        "src"
+    ],
+    "references": [
+        {
+            "path": "./tsconfig.node.json"
+        }
+    ]
+}

package/templates/blank/tsconfig.node.json

@@ -0,0 +1,12 @@
+{
+    "compilerOptions": {
+        "composite": true,
+        "skipLibCheck": true,
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "allowSyntheticDefaultImports": true
+    },
+    "include": [
+        "vite.config.ts"
+    ]
+}

package/templates/blank/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+    plugins: [react()],
+})

package/templates/starter/.env.example

@@ -0,0 +1,14 @@
+# Aura Configuration
+# API Key for Aura Proxy (if using managed service)
+VITE_AURA_API_KEY=
+
+# YouTube API Key (for YouTubeAIR)
+# Get one here: https://console.cloud.google.com/apis/credentials
+VITE_YOUTUBE_API_KEY=
+
+# Saga Backend URL (for fallback options)
+# Points to the deployed Cloud Run proxy by default
+VITE_SAGA_API_URL=https://auraproxy-7bpt7e5tua-uc.a.run.app
+
+# AlphaVantage Key (for StocksAIR)
+STOCK_API_KEY=

package/templates/starter/README.md

@@ -0,0 +1,31 @@
+# 🚀 Aura Starter Project
+
+Welcome to your first Aura project! Aura is a UX framework designed for the **Gen-AI age**, following the **[[UI Retrieval Philosophy]]**.
+
+This project provides a pre-configured environment to build and test **Agentic Interface Respondents (AIRs)** instantly using our built-in trial proxy.
+
+## 📖 Documentation Hub
+
+To get started and master the Aura ecosystem, please refer to our official Wiki:
+
+- **[[Aura Starter Quickstart]]**: Get up and running in 5 minutes.
+- **[[AIR Anatomy]]**: Understand the building blocks of an agentic interface.
+- **[[Aura Starter Rate Limits]]**: Details on your zero-config trial quota.
+- **[[Aura Starter Upgrade Guide]]**: How to use your own API keys for production.
+
+## 🛠️ Commands
+
+Inside your project directory, you can run:
+
+| Command | Description |
+| :--- | :--- |
+| `npm run dev` | Spins up the development server and launches **The Space**. |
+| `npm run build` | Builds the project for production deployment. |
+| `npm run preview` | Previews the production build locally. |
+
+---
+
+## 🏗️ Architecture Note
+Aura is not just a layout; it's an environment. Your AIRs (located in `src/airs/`) communicate via **[[Flux]]** and are managed by the **Atmosphere** (Registry). 
+
+For advanced orchestration and multi-agent coordination, visit the **[[Developer-Guide]]**.

package/templates/starter/_gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/templates/starter/aura.config.ts

@@ -0,0 +1,19 @@
+/**
+ * Aura Configuration
+ * 
+ * This file configures the Aura features used by this application.
+ */
+
+// Local AIRs that this application uses
+export const LOCAL_AIRS = [
+    'tasks-air',
+    'youtube-player-air',
+    'stocks-air',
+    'currency-air'
+];
+
+// Tour flow config path
+export const TOUR_FLOW_PATH = './src/components/TourGuide/tour-flow.yaml';
+
+// Default project ID for the tour
+export const DEFAULT_PROJECT_ID = 'aura-tour-demo';

package/templates/starter/eslint.config.js

@@ -0,0 +1,23 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+  },
+])

package/templates/starter/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/png" href="/favicon.png" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Aura Starter</title>
+</head>
+
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+
+</html>

package/templates/starter/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "aura-starter",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@minnai/aura": "^0.1.6",
+    "@monaco-editor/react": "^4.7.0",
+    "firebase": "^12.8.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router-dom": "^7.12.0",
+    "recharts": "^3.7.0",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@types/react-router-dom": "^5.3.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4"
+  }
+}

package/templates/starter/public/usd.json

@@ -0,0 +1,9 @@
+{
+    "base": "USD",
+    "rates": {
+        "EUR": 0.92,
+        "GBP": 0.79,
+        "JPY": 148.5,
+        "CAD": 1.35
+    }
+}

package/templates/starter/public/vite.svg

@@ -0,0 +1 @@
+[BINARY_CONTENT]

package/templates/starter/src/App.css

@@ -0,0 +1,32 @@
+#root {
+  width: 100vw;
+  height: 100vh;
+  margin: 0;
+  padding: 0;
+}
+
+:root {
+  --bg-app: #f5f5f7;
+  --bg-sidebar: #ffffff;
+  --bg-primary: #ffffff;
+  --bg-secondary: #f0f0f5;
+  --text-primary: #1d1d1f;
+  --text-secondary: #86868b;
+  --text-tertiary: #d2d2d7;
+  --border-color: #e5e5e5;
+  --border-subtle: rgba(0, 0, 0, 0.05);
+  --accent-primary: #007aff;
+  --accent-hover: #0062cc;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  padding: 0;
+  background-color: var(--bg-app);
+  color: var(--text-primary);
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+}

package/templates/starter/src/App.tsx

@@ -0,0 +1,82 @@
+import { useState, useEffect } from 'react';
+import { BrowserRouter, Routes, Route, useSearchParams } from 'react-router-dom';
+import { Space, ControllerProvider, ChatInterface, createStorage } from '@minnai/aura';
+import { AuraProvider } from '@minnai/aura/sdk';
+import { flux } from '@minnai/aura/flux/index';
+import { registerExampleAIRs } from './ambiance';
+import { AnalyticsTracker } from './components/AnalyticsTracker';
+import { TourGuide } from './components/TourGuide';
+import { analyticsService } from './services/AnalyticsService';
+import { ProjectSidebar } from './components/ProjectSidebar/ProjectSidebar';
+import './App.css';
+
+const baseAuraConfig = {
+  llm: {
+    gatewayUrl: 'https://auraproxy-7bpt7e5tua-uc.a.run.app',
+    proxyUrl: 'https://auraproxy-7bpt7e5tua-uc.a.run.app'
+  },
+  apiUrl: 'https://auraproxy-7bpt7e5tua-uc.a.run.app',
+  storage: {
+    documents: { driver: 'indexeddb' as any },
+    objects: { driver: 'indexeddb' as any }
+  }
+};
+
+createStorage(baseAuraConfig.storage);
+
+const defaultProjectId = 'aura-tour-demo';
+
+function Home() {
+  const [searchParams] = useSearchParams();
+  const projectId = searchParams.get('project') || defaultProjectId;
+
+  return (
+    <div style={{ display: 'flex', height: '100vh', width: '100vw', background: '#f5f5f7' }}>
+      {/* Reset explicit projectId passing to TourController if it reads from hook, or pass it */}
+      {/* We will pass it to keep it pure if possible, or render it here knowing it can use hooks */}
+      <TourGuide projectId={projectId} />
+      <ProjectSidebar currentProjectId={projectId} />
+      <aside style={{
+        width: '350px',
+        borderRight: '1px solid #ddd',
+        background: 'white',
+        display: 'flex',
+        flexDirection: 'column',
+        zIndex: 10
+      }}>
+        <ChatInterface
+          placeholder="Talk to Aura..."
+        />
+      </aside>
+      <main style={{ flex: 1, position: 'relative', overflow: 'hidden', background: '#fff' }}>
+        <Space projectId={projectId} />
+      </main>
+    </div>
+  );
+}
+
+function App() {
+  const [sessionId] = useState(() => 'sess_' + Math.random().toString(36).substr(2, 9));
+  const config = { ...baseAuraConfig, sessionId };
+
+  useEffect(() => {
+    registerExampleAIRs();
+    analyticsService.startTTVTimer();
+    (window as any).flux = flux;
+  }, []);
+
+  return (
+    <AuraProvider config={config}>
+      <ControllerProvider>
+        <BrowserRouter>
+          <AnalyticsTracker />
+          <Routes>
+            <Route path="/" element={<Home />} />
+          </Routes>
+        </BrowserRouter>
+      </ControllerProvider>
+    </AuraProvider>
+  );
+}
+
+export default App;