@flight-framework/cli 0.0.16 → 0.2.0

package/package.json

@@ -1,54 +1,54 @@
 {
-    "name": "@flight-framework/cli",
-    "version": "0.0.16",
-    "description": "Command-line interface for Flight Framework",
-    "keywords": [
-        "flight",
-        "cli",
-        "framework"
-    ],
-    "license": "MIT",
-    "author": "Flight Contributors",
-    "type": "module",
-    "bin": {
-        "flight": "./dist/bin.js"
-    },
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "files": [
-        "dist",
-        "templates"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsup --watch",
-        "test": "vitest run",
-        "lint": "eslint src/",
-        "clean": "rimraf dist",
-        "typecheck": "tsc --noEmit"
-    },
-    "dependencies": {
-        "@flight-framework/core": "^0.3.0",
-        "@flight-framework/http": "0.0.3",
-        "cac": "^6.7.14",
-        "picocolors": "^1.1.0",
-        "prompts": "^2.4.2"
-    },
-    "devDependencies": {
-        "@types/node": "^22.0.0",
-        "@types/prompts": "^2.4.9",
-        "rimraf": "^6.0.0",
-        "tsup": "^8.0.0",
-        "typescript": "^5.7.0",
-        "vitest": "^2.0.0"
-    },
-    "peerDependencies": {
-        "vite": "^6.0.0 || ^7.0.0"
+  "name": "@flight-framework/cli",
+  "version": "0.2.0",
+  "description": "Command-line interface for Flight Framework",
+  "keywords": [
+    "flight",
+    "cli",
+    "framework"
+  ],
+  "license": "MIT",
+  "author": "Flight Contributors",
+  "type": "module",
+  "bin": {
+    "flight": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@flight-framework/core": "^0.3.0",
+    "@flight-framework/http": "0.0.3",
+    "cac": "^6.7.14",
+    "picocolors": "^1.1.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0 || ^7.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/templates/use-cases/api/README.md

@@ -0,0 +1,41 @@
+# API Starter
+
+A minimal API-only template with Flight. No UI framework.
+
+## Features
+
+- REST API routes
+- OpenAPI ready
+- Database integration ready
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+## Structure
+
+```
+src/routes/api/
+├── health.get.ts     # Health check
+├── users.get.ts      # List users
+├── users.post.ts     # Create user
+└── users/[id].get.ts # Get user by ID
+```
+
+## Example
+
+```typescript
+// src/routes/api/users.get.ts
+export function GET() {
+  return Response.json({ users: [] });
+}
+```
+
+## Customize
+
+- Add your database driver
+- Generate OpenAPI docs
+- Add authentication middleware

package/templates/use-cases/api/package.json.template

@@ -0,0 +1,14 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "flight dev",
+    "build": "flight build",
+    "start": "flight start"
+  },
+  "dependencies": {
+    "@flight-framework/http": "latest"
+  }
+}

package/templates/use-cases/api/src/routes/api/health.get.ts.template

@@ -0,0 +1,3 @@
+export function GET() {
+  return Response.json({ status: 'ok', timestamp: Date.now() });
+}

package/templates/use-cases/blog/README.md

@@ -0,0 +1,47 @@
+# Blog Starter
+
+A minimal blog template with Flight.
+
+## Features
+
+- File-based blog posts
+- SEO optimized
+- RSS feed ready
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+## Structure
+
+```
+src/
+├── routes/
+│   ├── index.page.tsx     # Home page
+│   └── blog/
+│       └── [slug].page.tsx  # Blog post
+└── content/
+    └── posts/             # Add .md files here
+```
+
+## Add Posts
+
+Create markdown files in `src/content/posts/`:
+
+```markdown
+---
+title: My First Post
+date: 2026-01-13
+---
+
+Your content here.
+```
+
+## Customize
+
+- Edit `flight.config.ts` for SEO defaults
+- Add components in `src/components/`
+- Modify layout in `src/routes/_layout.tsx`

package/templates/use-cases/blog/flight.config.ts.template

@@ -0,0 +1,11 @@
+import { defineConfig } from '@flight-framework/core';
+
+export default defineConfig({
+  seo: {
+    titleTemplate: '%s | {{PROJECT_NAME}}',
+  },
+  routeRules: {
+    '/': { prerender: true },
+    '/blog/**': { isr: 3600 },
+  },
+});

package/templates/use-cases/blog/package.json.template

@@ -0,0 +1,15 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "flight dev",
+    "build": "flight build",
+    "preview": "flight preview"
+  },
+  "dependencies": {
+    "@flight-framework/core": "latest",
+    "@flight-framework/seo": "latest"
+  }
+}

package/templates/use-cases/blog/src/routes/blog/[slug].page.tsx.template

@@ -0,0 +1,23 @@
+import { notFound } from '@flight-framework/core';
+
+export async function loader({ params }) {
+  // Replace with your content loading logic
+  const post = await getPost(params.slug);
+  if (!post) notFound();
+  return { post };
+}
+
+export default function BlogPost({ data }) {
+  return (
+    <article>
+      <h1>{data.post.title}</h1>
+      <time>{data.post.date}</time>
+      <div dangerouslySetInnerHTML={{ __html: data.post.content }} />
+    </article>
+  );
+}
+
+// Placeholder - implement your own content loading
+async function getPost(slug: string) {
+  return null; // Load from filesystem, CMS, or database
+}

package/templates/use-cases/blog/src/routes/index.page.tsx.template

@@ -0,0 +1,9 @@
+export default function HomePage() {
+  return (
+    <main>
+      <h1>Welcome to {{PROJECT_NAME}}</h1>
+      <p>Your blog is ready. Add posts in <code>src/content/posts/</code></p>
+      <a href="/blog">View Posts →</a>
+    </main>
+  );
+}

package/templates/use-cases/docs/README.md

@@ -0,0 +1,49 @@
+# Documentation Starter
+
+A minimal documentation site template with Flight.
+
+## Features
+
+- Markdown content
+- Auto-navigation
+- SEO optimized
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+## Structure
+
+```
+src/
+├── content/
+│   ├── index.md           # Home
+│   ├── getting-started.md
+│   └── api/
+│       └── reference.md
+└── routes/
+    └── [...slug].page.tsx  # Renders markdown
+```
+
+## Add Pages
+
+Create markdown files in `src/content/`:
+
+```markdown
+---
+title: My Page
+---
+
+# My Page
+
+Content here.
+```
+
+## Customize
+
+- Add sidebar navigation
+- Customize layout
+- Add search functionality

package/templates/use-cases/docs/package.json.template

@@ -0,0 +1,15 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "flight dev",
+    "build": "flight build",
+    "preview": "flight preview"
+  },
+  "dependencies": {
+    "@flight-framework/core": "latest",
+    "@flight-framework/seo": "latest"
+  }
+}

package/templates/use-cases/docs/src/content/index.md.template

@@ -0,0 +1,16 @@
+---
+title: Welcome
+---
+
+# {{PROJECT_NAME}} Documentation
+
+Welcome to your documentation site.
+
+## Getting Started
+
+Add markdown files to `src/content/` to create pages.
+
+## Next Steps
+
+- [Getting Started](./getting-started.md)
+- [API Reference](./api/reference.md)

package/templates/use-cases/ecommerce/README.md

@@ -0,0 +1,32 @@
+# E-commerce Starter
+
+A minimal e-commerce template with Flight.
+
+## Features
+
+- Product catalog
+- Cart ready (implement your logic)
+- Payment integration ready
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+## Structure
+
+```
+src/routes/
+├── index.page.tsx        # Home
+├── products/
+│   └── [id].page.tsx     # Product detail
+└── cart.page.tsx         # Shopping cart
+```
+
+## Customize
+
+- Add your database logic in route loaders
+- Connect your payment provider
+- Extend with authentication

package/templates/use-cases/ecommerce/package.json.template

@@ -0,0 +1,16 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "flight dev",
+    "build": "flight build",
+    "preview": "flight preview"
+  },
+  "dependencies": {
+    "@flight-framework/core": "latest",
+    "@flight-framework/seo": "latest",
+    "@flight-framework/image": "latest"
+  }
+}

package/templates/use-cases/ecommerce/src/routes/index.page.tsx.template

@@ -0,0 +1,9 @@
+export default function HomePage() {
+  return (
+    <main>
+      <h1>{{PROJECT_NAME}}</h1>
+      <p>Your store is ready.</p>
+      <a href="/products">Browse Products →</a>
+    </main>
+  );
+}

package/templates/use-cases/saas/README.md

@@ -0,0 +1,34 @@
+# SaaS Starter
+
+A minimal SaaS application template with Flight.
+
+## Features
+
+- Auth ready (add your provider)
+- Dashboard layout
+- User settings page
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+## Structure
+
+```
+src/routes/
+├── index.page.tsx           # Landing page
+├── login.page.tsx           # Login
+├── dashboard/
+│   ├── _middleware.ts       # Auth guard
+│   ├── index.page.tsx       # Dashboard home
+│   └── settings.page.tsx    # User settings
+```
+
+## Customize
+
+- Connect authentication provider
+- Add database integration
+- Extend dashboard with your features

package/templates/use-cases/saas/package.json.template

@@ -0,0 +1,15 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "flight dev",
+    "build": "flight build",
+    "preview": "flight preview"
+  },
+  "dependencies": {
+    "@flight-framework/core": "latest",
+    "@flight-framework/auth": "latest"
+  }
+}

package/templates/use-cases/saas/src/routes/index.page.tsx.template

@@ -0,0 +1,9 @@
+export default function LandingPage() {
+  return (
+    <main>
+      <h1>{{PROJECT_NAME}}</h1>
+      <p>Your SaaS application is ready.</p>
+      <a href="/login">Get Started →</a>
+    </main>
+  );
+}