@useatlas/create 0.0.2 → 0.0.4

package/templates/nextjs-standalone/package.json

@@ -19,19 +19,24 @@
     "@ai-sdk/react": "^3.0.99",
     "ai": "^6.0.97",
     "@better-auth/api-key": "^1.5.1",
-    "clsx": "^2.1.1",
     "better-auth": "^1.5.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "croner": "^9.0.0",
     "hono": "^4.12.3",
     "jose": "^6.1.3",
     "js-yaml": "^4.1.1",
     "just-bash": "^2.10.2",
-    "lucide-react": "^0.576.0",
+    "lucide-react": "^0.577.0",
     "mysql2": "^3.18.0",
     "next": "^16.1.6",
     "node-sql-parser": "^5.4.0",
+    "nuqs": "^2.8.9",
     "pg": "^8.18.0",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
+    "radix-ui": "^1.4.3",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "react-markdown": "^10.1.0",
@@ -45,6 +50,7 @@
     "@vercel/sandbox": "^1"
   },
   "devDependencies": {
+    "@clack/prompts": "^0.10.0",
     "@eslint/js": "^10.0.1",
     "@next/eslint-plugin-next": "^16.1.6",
     "@tailwindcss/postcss": "^4.2.1",
@@ -54,9 +60,12 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@types/react-syntax-highlighter": "^15.5.13",
+    "@types/bun": "^1.3.9",
     "@typescript/native-preview": "^7.0.0-dev.20260226.1",
     "eslint": "^10.0.2",
     "tailwindcss": "^4.2.1",
+    "shadcn": "^3.8.5",
+    "picocolors": "^1.1.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.56.1"
   }

package/templates/nextjs-standalone/scripts/migrate-auth.ts

@@ -0,0 +1,25 @@
+/**
+ * Build-time auth migration for Vercel deployments.
+ *
+ * On Vercel, there is no persistent server boot — the Hono app runs inside
+ * a serverless catch-all route. The standalone server (server.ts) normally
+ * calls migrateAuthTables() at boot, but that code path is never hit on
+ * Vercel. This script bridges the gap by running the same migration at
+ * build time, right after seed-demo.ts.
+ *
+ * Creates Better Auth tables (user, session, account, etc.), the audit_log
+ * table, and seeds a dev admin account when ATLAS_ADMIN_EMAIL is set.
+ */
+
+import { migrateAuthTables } from "@atlas/api/lib/auth/migrate";
+
+try {
+  await migrateAuthTables();
+  console.log("migrate-auth: complete");
+} catch (err) {
+  console.error(
+    "migrate-auth: failed —",
+    err instanceof Error ? err.stack : err,
+  );
+  process.exit(1);
+}

package/templates/nextjs-standalone/scripts/seed-demo.ts

@@ -0,0 +1,94 @@
+/**
+ * Build-time demo data seeder for Vercel deployments.
+ *
+ * When ATLAS_DEMO_DATA=true, seeds the Neon-provisioned database with demo
+ * data (companies, people, accounts — ~30KB). Idempotent: skips if data
+ * already exists. Runs during `next build` on Vercel.
+ *
+ * Resolves the database URL from DATABASE_URL_UNPOOLED or DATABASE_URL
+ * (set automatically by Neon's Vercel integration).
+ */
+
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import pg from "pg";
+
+if (process.env.ATLAS_DEMO_DATA !== "true") {
+  console.log("seed-demo: ATLAS_DEMO_DATA is not 'true' — skipping");
+  process.exit(0);
+}
+
+// Prefer unpooled for DDL/migrations (PgBouncer can interfere with multi-statement transactions)
+const url = process.env.DATABASE_URL_UNPOOLED || process.env.DATABASE_URL;
+if (!url) {
+  console.error("seed-demo: no DATABASE_URL or DATABASE_URL_UNPOOLED — cannot seed");
+  process.exit(1);
+}
+
+// Normalize sslmode: pg v8 treats 'require' as 'verify-full' but warns about it.
+const connString = url.replace(
+  /([?&])sslmode=require(?=&|$)/,
+  "$1sslmode=verify-full",
+);
+
+const client = new pg.Client({
+  connectionString: connString,
+  connectionTimeoutMillis: 10_000,
+});
+
+try {
+  await client.connect();
+
+  // Check if demo data already exists
+  const result = await client.query(`
+    SELECT EXISTS (
+      SELECT 1 FROM information_schema.tables
+      WHERE table_schema = 'public' AND table_name = 'companies'
+    ) AS table_exists
+  `);
+
+  if (result.rows[0]?.table_exists) {
+    const count = await client.query("SELECT count(*) AS n FROM companies");
+    if (parseInt(count.rows[0]?.n ?? "0", 10) > 0) {
+      console.log("seed-demo: demo data already exists, skipping");
+      await client.end();
+      process.exit(0);
+    }
+    console.log("seed-demo: companies table exists but is empty, re-seeding...");
+  }
+
+  // Read the seed SQL
+  const sqlPath = resolve(import.meta.dirname, "../data/demo.sql");
+  let sql: string;
+  try {
+    sql = readFileSync(sqlPath, "utf-8");
+  } catch (err) {
+    throw new Error(
+      `Failed to read ${sqlPath}: ${err instanceof Error ? err.message : err}`
+    );
+  }
+
+  // Execute inside a transaction
+  await client.query("BEGIN");
+  try {
+    await client.query(sql);
+    await client.query("COMMIT");
+  } catch (err) {
+    try { await client.query("ROLLBACK"); } catch (rollbackErr) {
+      console.warn("seed-demo: ROLLBACK failed —", rollbackErr instanceof Error ? rollbackErr.message : rollbackErr);
+    }
+    throw err;
+  }
+
+  const verify = await client.query("SELECT count(*) AS n FROM companies");
+  console.log(`seed-demo: seeded ${verify.rows[0]?.n ?? 0} companies successfully`);
+
+  await client.end();
+  process.exit(0);
+} catch (err) {
+  console.error("seed-demo: failed —", err instanceof Error ? err.stack : err);
+  try { await client.end(); } catch (cleanupErr) {
+    console.warn("seed-demo: cleanup failed —", cleanupErr instanceof Error ? cleanupErr.message : cleanupErr);
+  }
+  process.exit(1);
+}

package/templates/nextjs-standalone/semantic/catalog.yml

@@ -1,5 +1,64 @@
-# Atlas Semantic Layer — Catalog
-# Run `bun run atlas -- init` to auto-generate from your database.
 version: "1.0"
-entities: []
+name: Atlas Demo — SaaS CRM
+description: |
+  B2B SaaS company CRM dataset. Tracks companies (customers), the people who work
+  there (contacts), and subscription accounts with plan tiers and MRR.
+  Use this dataset to explore revenue analysis, customer segmentation,
+  churn patterns, and org-level reporting.
+
+entities:
+  - name: Companies
+    file: entities/companies.yml
+    grain: one row per customer company
+    description: >
+      Customer companies with firmographic data — industry, headcount,
+      geography, revenue, and valuation.
+    use_for:
+      - Firmographic segmentation (industry, country, company size)
+      - Revenue and valuation analysis
+      - Customer base composition
+    common_questions:
+      - What industries make up our customer base?
+      - Which countries have the most customers?
+      - What is the average company revenue by industry?
+      - How many enterprise-size companies (500+ employees) do we have?
+
+  - name: People
+    file: entities/people.yml
+    grain: one row per contact
+    description: >
+      Contacts at customer companies — department, seniority, title,
+      and start date. Linked to companies via company_id.
+    use_for:
+      - Stakeholder mapping by department and seniority
+      - Org chart analysis per company
+      - Tenure and hiring trend analysis
+    common_questions:
+      - How many contacts do we have per company?
+      - What is the department breakdown across all contacts?
+      - Which companies have the most executive-level contacts?
+      - What seniority levels are most common?
+
+  - name: Accounts
+    file: entities/accounts.yml
+    grain: one row per subscription account
+    description: >
+      Subscription accounts with plan tier, billing status, MRR
+      (monthly_value), and contract dates. Linked to companies via company_id.
+    use_for:
+      - MRR and revenue analysis by plan
+      - Churn and retention analysis
+      - Contract lifecycle tracking
+      - Cross-entity analysis joining to companies and people
+    common_questions:
+      - What is total MRR by plan type?
+      - How many accounts are churned vs active?
+      - What is the average contract length?
+      - Which companies have the highest MRR?
+
 glossary: glossary.yml
+metrics:
+  - file: metrics/accounts.yml
+    description: Subscription and revenue metrics (MRR, churn rate, ARPA)
+  - file: metrics/companies.yml
+    description: Customer base metrics (count, avg revenue, industry breakdown)

package/templates/nextjs-standalone/semantic/entities/accounts.yml

@@ -0,0 +1,162 @@
+name: Accounts
+type: fact_table
+table: accounts
+grain: one row per subscription account
+description: |
+  Subscription accounts representing our billing relationship with each customer.
+  Each account belongs to one company and has a plan tier (Free, Starter, Pro,
+  Enterprise), a billing status (Active, Inactive, Suspended, Churned), and a
+  monthly_value representing MRR contribution. Contract dates track the lifecycle.
+  A company can have multiple accounts (e.g. separate subscriptions for different teams).
+
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key — unique account identifier
+    primary_key: true
+
+  - name: company_id
+    sql: company_id
+    type: number
+    description: Foreign key to companies — which customer owns this account
+
+  - name: plan
+    sql: plan
+    type: string
+    description: |
+      Subscription tier. Determines pricing and feature access.
+      Free = $0, Starter = ~$49-89, Pro = ~$299-500, Enterprise = ~$5K-15K.
+    sample_values: [Enterprise, Pro, Starter, Free]
+
+  - name: status
+    sql: status
+    type: string
+    description: |
+      Current billing status. Active = paying, Inactive = paused,
+      Suspended = payment issue, Churned = cancelled.
+    sample_values: [Active, Churned, Inactive, Suspended]
+
+  - name: monthly_value
+    sql: monthly_value
+    type: number
+    description: |
+      Monthly Recurring Revenue (MRR) from this account in dollars.
+      Free accounts have $0. This is the core revenue metric.
+
+  - name: contract_start
+    sql: contract_start
+    type: date
+    description: Date the subscription began
+
+  - name: contract_end
+    sql: contract_end
+    type: date
+    description: |
+      Date the subscription ended. NULL means the account is still under contract.
+      Set when an account churns or is terminated.
+
+  - name: monthly_value_bucket
+    sql: |-
+      CASE
+        WHEN monthly_value = 0 THEN 'Free'
+        WHEN monthly_value < 100 THEN 'Low'
+        WHEN monthly_value < 1000 THEN 'Mid'
+        ELSE 'High'
+      END
+    type: string
+    description: MRR tier bucket — Free / Low / Mid / High
+    virtual: true
+    sample_values: [Free, Low, Mid, High]
+
+  - name: contract_start_year
+    sql: EXTRACT(YEAR FROM contract_start)
+    type: number
+    description: Year the contract started — useful for cohort analysis
+    virtual: true
+
+  - name: contract_start_month
+    sql: TO_CHAR(contract_start, 'YYYY-MM')
+    type: string
+    description: Year-month the contract started
+    virtual: true
+
+  - name: is_churned
+    sql: CASE WHEN status = 'Churned' THEN true ELSE false END
+    type: boolean
+    description: Whether this account has churned
+    virtual: true
+
+measures:
+  - name: account_count
+    sql: id
+    type: count_distinct
+    description: Number of unique accounts
+
+  - name: total_mrr
+    sql: monthly_value
+    type: sum
+    description: Total Monthly Recurring Revenue
+
+  - name: avg_mrr
+    sql: monthly_value
+    type: avg
+    description: Average MRR per account
+
+joins:
+  - target_entity: Companies
+    relationship: many_to_one
+    join_columns:
+      from: company_id
+      to: id
+    description: Each account belongs to one company (customer)
+
+use_cases:
+  - MRR analysis — total, by plan, by status, over time
+  - Churn analysis — churned vs active accounts, churn rate by plan
+  - Revenue segmentation — which plans drive the most revenue
+  - Contract lifecycle — average duration, upcoming renewals
+  - Cross-entity joins to companies for firmographic revenue analysis
+
+query_patterns:
+  - name: mrr_by_plan
+    description: Total MRR and account count by plan tier
+    sql: |-
+      SELECT plan,
+             SUM(monthly_value) AS total_mrr,
+             COUNT(*) AS account_count,
+             AVG(monthly_value) AS avg_mrr
+      FROM accounts
+      WHERE status = 'Active'
+      GROUP BY plan
+      ORDER BY total_mrr DESC
+
+  - name: churn_rate_by_plan
+    description: Churn rate by plan type
+    sql: |-
+      SELECT plan,
+             COUNT(*) FILTER (WHERE status = 'Churned') AS churned,
+             COUNT(*) AS total,
+             ROUND(100.0 * COUNT(*) FILTER (WHERE status = 'Churned') / COUNT(*), 1) AS churn_pct
+      FROM accounts
+      GROUP BY plan
+      ORDER BY churn_pct DESC
+
+  - name: accounts_by_status
+    description: Account distribution by billing status
+    sql: |-
+      SELECT status, COUNT(*) AS count
+      FROM accounts
+      GROUP BY status
+      ORDER BY count DESC
+
+  - name: mrr_by_contract_year
+    description: MRR cohort analysis by contract start year
+    sql: |-
+      SELECT EXTRACT(YEAR FROM contract_start) AS cohort_year,
+             SUM(monthly_value) AS total_mrr,
+             COUNT(*) AS accounts
+      FROM accounts
+      WHERE status = 'Active'
+      GROUP BY cohort_year
+      ORDER BY cohort_year

package/templates/nextjs-standalone/semantic/entities/companies.yml

@@ -0,0 +1,143 @@
+name: Companies
+type: dimension_table
+table: companies
+grain: one row per customer company
+description: |
+  Customer companies (our B2B clients). Contains firmographic data including
+  industry vertical, headcount, founding year, HQ country, annual revenue,
+  and valuation. Each company can have multiple accounts (subscriptions)
+  and multiple people (contacts). This is the central dimension table for
+  customer-level analysis.
+
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key — unique company identifier
+    primary_key: true
+
+  - name: name
+    sql: name
+    type: string
+    description: Company name
+    sample_values: [Acme Corp, DataFlow Inc, CloudSync, RetailHub]
+
+  - name: industry
+    sql: industry
+    type: string
+    description: Business sector / vertical
+    sample_values: [Education, Energy, Finance, Healthcare, Manufacturing, Media, Retail, Technology]
+
+  - name: employee_count
+    sql: employee_count
+    type: number
+    description: Total headcount at the company
+
+  - name: founded_year
+    sql: founded_year
+    type: number
+    description: Year the company was founded
+
+  - name: country
+    sql: country
+    type: string
+    description: ISO 2-letter code for company HQ location
+    sample_values: [AU, BR, CA, DE, FR, IN, JP, SG, UK, US]
+
+  - name: revenue
+    sql: revenue
+    type: number
+    description: Annual revenue in dollars (the company's own revenue, not what they pay us)
+
+  - name: valuation
+    sql: valuation
+    type: number
+    description: Company valuation in dollars
+
+  - name: company_size
+    sql: |-
+      CASE
+        WHEN employee_count < 100 THEN 'Small'
+        WHEN employee_count < 300 THEN 'Mid-Market'
+        ELSE 'Enterprise'
+      END
+    type: string
+    description: Company size segment based on headcount
+    virtual: true
+    sample_values: [Small, Mid-Market, Enterprise]
+
+  - name: revenue_tier
+    sql: |-
+      CASE
+        WHEN revenue < 10000000 THEN 'Under $10M'
+        WHEN revenue < 50000000 THEN '$10M-$50M'
+        WHEN revenue < 100000000 THEN '$50M-$100M'
+        ELSE '$100M+'
+      END
+    type: string
+    description: Revenue tier for segmentation
+    virtual: true
+    sample_values: [Under $10M, $10M-$50M, $50M-$100M, $100M+]
+
+measures:
+  - name: company_count
+    sql: id
+    type: count_distinct
+    description: Number of unique companies
+
+  - name: avg_employee_count
+    sql: employee_count
+    type: avg
+    description: Average headcount per company
+
+  - name: total_revenue
+    sql: revenue
+    type: sum
+    description: Combined annual revenue of all companies
+
+  - name: avg_revenue
+    sql: revenue
+    type: avg
+    description: Average annual revenue per company
+
+  - name: avg_valuation
+    sql: valuation
+    type: avg
+    description: Average company valuation
+
+use_cases:
+  - Customer segmentation by industry, country, company size
+  - Revenue and valuation analysis across the customer base
+  - Firmographic profiling for ICP (ideal customer profile) analysis
+  - Join to accounts for revenue-per-company analysis
+  - Join to people for stakeholder density per company
+
+query_patterns:
+  - name: companies_by_industry
+    description: Customer count and avg revenue by industry
+    sql: |-
+      SELECT industry,
+             COUNT(*) AS company_count,
+             AVG(revenue) AS avg_revenue,
+             AVG(employee_count) AS avg_headcount
+      FROM companies
+      GROUP BY industry
+      ORDER BY company_count DESC
+
+  - name: companies_by_country
+    description: Customer distribution by country
+    sql: |-
+      SELECT country,
+             COUNT(*) AS company_count,
+             SUM(revenue) AS total_revenue
+      FROM companies
+      GROUP BY country
+      ORDER BY company_count DESC
+
+  - name: top_companies_by_revenue
+    description: Largest customers by annual revenue
+    sql: |-
+      SELECT name, industry, country, revenue, employee_count
+      FROM companies
+      ORDER BY revenue DESC
+      LIMIT 10

package/templates/nextjs-standalone/semantic/entities/people.yml

@@ -0,0 +1,132 @@
+name: People
+type: dimension_table
+table: people
+grain: one row per contact
+description: |
+  Contacts at customer companies. Each person has a department, seniority level,
+  job title, and start date. Linked to companies via company_id. Use for
+  stakeholder mapping, org analysis, and understanding who we're selling to
+  and supporting at each company.
+
+dimensions:
+  - name: id
+    sql: id
+    type: number
+    description: Primary key — unique contact identifier
+    primary_key: true
+
+  - name: name
+    sql: name
+    type: string
+    description: Full name of the contact
+
+  - name: email
+    sql: email
+    type: string
+    description: Work email address
+
+  - name: company_id
+    sql: company_id
+    type: number
+    description: Foreign key to companies — which company this person works at
+
+  - name: department
+    sql: department
+    type: string
+    description: Functional department within the company
+    sample_values: [Engineering, Finance, Marketing, Operations, Product, Sales]
+
+  - name: seniority
+    sql: seniority
+    type: string
+    description: Career level — indicates decision-making authority
+    sample_values: [Executive, Senior, Mid, Junior]
+
+  - name: title
+    sql: title
+    type: string
+    description: Job title (e.g. CFO, Backend Engineer, Account Executive)
+
+  - name: start_date
+    sql: start_date
+    type: date
+    description: Date the person started at their company
+
+  - name: start_date_year
+    sql: EXTRACT(YEAR FROM start_date)
+    type: number
+    description: Year the person started — useful for tenure analysis
+    virtual: true
+
+  - name: tenure_years
+    sql: EXTRACT(YEAR FROM AGE(CURRENT_DATE, start_date))
+    type: number
+    description: Approximate years of tenure at the company
+    virtual: true
+
+measures:
+  - name: contact_count
+    sql: id
+    type: count_distinct
+    description: Number of unique contacts
+
+  - name: avg_tenure
+    sql: EXTRACT(YEAR FROM AGE(CURRENT_DATE, start_date))
+    type: avg
+    description: Average tenure in years
+
+joins:
+  - target_entity: Companies
+    relationship: many_to_one
+    join_columns:
+      from: company_id
+      to: id
+    description: Each contact belongs to one company
+
+use_cases:
+  - Stakeholder mapping — who are the key contacts at each company
+  - Department breakdown — what functions are represented
+  - Seniority analysis — how many executives vs individual contributors
+  - Hiring trends — when were contacts added, by year
+  - Join to companies + accounts for full customer intelligence
+
+query_patterns:
+  - name: contacts_by_department
+    description: Contact count by department
+    sql: |-
+      SELECT department,
+             COUNT(*) AS contact_count
+      FROM people
+      GROUP BY department
+      ORDER BY contact_count DESC
+
+  - name: contacts_by_seniority
+    description: Contact distribution by seniority level
+    sql: |-
+      SELECT seniority,
+             COUNT(*) AS contact_count
+      FROM people
+      GROUP BY seniority
+      ORDER BY contact_count DESC
+
+  - name: executives_by_company
+    description: Executive contacts per company
+    sql: |-
+      SELECT c.name AS company,
+             COUNT(*) AS executive_count
+      FROM people p
+      JOIN companies c ON p.company_id = c.id
+      WHERE p.seniority = 'Executive'
+      GROUP BY c.name
+      ORDER BY executive_count DESC
+
+  - name: contacts_per_company
+    description: Contact density per company
+    sql: |-
+      SELECT c.name AS company,
+             COUNT(*) AS contact_count,
+             c.employee_count AS total_employees
+      FROM people p
+      JOIN companies c ON p.company_id = c.id
+      GROUP BY c.name, c.employee_count
+      ORDER BY contact_count DESC