ntc-dev-kit 1.3.0__tar.gz → 1.3.1__tar.gz

{ntc_dev_kit-1.3.0 → ntc_dev_kit-1.3.1}/MANIFEST.in

@@ -3,7 +3,7 @@ include LICENSE
 include requirements.txt
 recursive-include ntc/templates *.py *.json *.md *.txt *.html *.ts *.tsx *.css *.scss *.yml *.yaml *.sh *.conf *.cfg
 recursive-include ntc/templates *.env.example *.gitignore
-recursive-include ntc/templates *.js *.mjs *.dart Dockerfile captain-definition
+recursive-include ntc/templates *.js *.mjs *.dart *.svg *.png *.ico Dockerfile captain-definition
 
 global-exclude __pycache__
 global-exclude *.py[co]

{ntc_dev_kit-1.3.0/ntc_dev_kit.egg-info → ntc_dev_kit-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ntc-dev-kit
-Version: 1.3.0
+Version: 1.3.1
 Summary: Nexent Toolkit Console - A CLI tool for scaffolding Django REST Framework, React, Next.js, and Flutter projects
 Home-page: https://github.com/nexent/ntc
 Author: Nexent
@@ -26,7 +26,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: colorama>=0.4.6
 Requires-Dist: pyyaml>=6.0
-Requires-Dist: textual>=0.47.0
+Requires-Dist: textual>=1.0
 Requires-Dist: tomli>=2.0; python_version < "3.11"
 Provides-Extra: dev
 Requires-Dist: build>=1.0; extra == "dev"
@@ -159,8 +159,12 @@ ntc clean --deep           # also node_modules and Python environments
 ntc add                    # another app, wired in like the rest
 ```
 
-In `ntc start`: **1-9** (or the tabs) switch app, **0** shows all, **r** restarts, **s** stops or
-starts, **o** opens it in the browser, **i** types into it (Flutter's `r` hot reload), **q** quits
+In `ntc start`, **All** is a grid of up to four terminals, one per app (**[** and **]** page
+through more), with each app's port and status on its border and its output colour-coded: errors
+red, warnings amber, ready/compiled green, HTTP status codes by class. **Tab** moves between the
+terminals and the keys act on the focused one: **r** restarts, **s** stops or starts, **o** opens
+it in the browser, **i** types into it (Flutter's `r` hot reload), **c** clears, **Enter** opens it
+full screen (**Esc** comes back). **1-9** jump to an app's own tab, **0** back to all, **q** quits
 and stops everything. Apps wait for the ones they `need` (the backend) before starting, and a port
 that's already taken is reported instead of crashing.
 

{ntc_dev_kit-1.3.0 → ntc_dev_kit-1.3.1}/README.md

@@ -118,8 +118,12 @@ ntc clean --deep           # also node_modules and Python environments
 ntc add                    # another app, wired in like the rest
 ```
 
-In `ntc start`: **1-9** (or the tabs) switch app, **0** shows all, **r** restarts, **s** stops or
-starts, **o** opens it in the browser, **i** types into it (Flutter's `r` hot reload), **q** quits
+In `ntc start`, **All** is a grid of up to four terminals, one per app (**[** and **]** page
+through more), with each app's port and status on its border and its output colour-coded: errors
+red, warnings amber, ready/compiled green, HTTP status codes by class. **Tab** moves between the
+terminals and the keys act on the focused one: **r** restarts, **s** stops or starts, **o** opens
+it in the browser, **i** types into it (Flutter's `r` hot reload), **c** clears, **Enter** opens it
+full screen (**Esc** comes back). **1-9** jump to an app's own tab, **0** back to all, **q** quits
 and stops everything. Apps wait for the ones they `need` (the backend) before starting, and a port
 that's already taken is reported instead of crashing.
 

{ntc_dev_kit-1.3.0 → ntc_dev_kit-1.3.1}/ntc/__init__.py

@@ -1,5 +1,5 @@
 """NTC - Nexent Toolkit Console."""
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"
 __author__ = "Nexent"
 __license__ = "MIT"

{ntc_dev_kit-1.3.0 → ntc_dev_kit-1.3.1}/ntc/templates/nextjs/.env.example

@@ -8,3 +8,9 @@ NEXT_PUBLIC_SITE_URL=http://localhost:3000
 # SEO Configuration
 NEXT_PUBLIC_SITE_DESCRIPTION=A modern website built with Next.js
 NEXT_PUBLIC_SITE_KEYWORDS=nextjs,react,typescript
+
+# Search engines: true on staging/preview copies (robots.txt then disallows everything)
+NEXT_PUBLIC_NOINDEX=false
+# Search console verification codes (leave empty to add no tag)
+NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION=
+NEXT_PUBLIC_BING_SITE_VERIFICATION=

ntc_dev_kit-1.3.1/ntc/templates/nextjs/public/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="32" height="32"><rect width="64" height="64" rx="14" fill="#0f172a"/><path d="M20 44V20h6l12 15V20h6v24h-6L26 29v15z" fill="#fff"/></svg>

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/about/page.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from 'next'
+import { SITE_NAME } from '@/utils/constants'
+
+export const metadata: Metadata = {
+  title: 'About',
+  description: `About ${SITE_NAME}.`,
+  alternates: { canonical: '/about' },
+}
+
+export default function About() {
+  return (
+    <section className="page">
+      <div className="container prose">
+        <h1>About {SITE_NAME}</h1>
+        <p>Tell visitors who you are, what you do and why it matters.</p>
+      </div>
+    </section>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/contact/page.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from 'next'
+import { SITE_NAME } from '@/utils/constants'
+
+export const metadata: Metadata = {
+  title: 'Contact',
+  description: `Get in touch with ${SITE_NAME}.`,
+  alternates: { canonical: '/contact' },
+}
+
+export default function Contact() {
+  return (
+    <section className="page">
+      <div className="container prose">
+        <h1>Contact</h1>
+        <p>
+          Email us at <a href="mailto:hello@example.com">hello@example.com</a> and we&apos;ll get back to you.
+        </p>
+      </div>
+    </section>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/error.tsx

@@ -0,0 +1,20 @@
+'use client'
+
+import { useEffect } from 'react'
+
+// Shown when a page throws while rendering. The header and footer (the layout) stay.
+export default function Error({ error, reset }: { error: Error & { digest?: string }; reset: () => void }) {
+  useEffect(() => {
+    console.error(error)
+  }, [error])
+
+  return (
+    <section className="page">
+      <div className="container prose">
+        <h1>Something went wrong</h1>
+        <p>Please try again. If it keeps happening, let us know.</p>
+        <p><button className="button" onClick={() => reset()}>Try again</button></p>
+      </div>
+    </section>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/globals.css

@@ -0,0 +1,198 @@
+/* Base styles sit in the base layer, so utility classes (e.g. Tailwind's, if added) override them
+   instead of losing to unlayered CSS. */
+@layer base {
+  :root {
+    --text: #0f172a;
+    --muted: #475569;
+    --background: #ffffff;
+    --surface: #f8fafc;
+    --border: #e2e8f0;
+    --accent: #0f172a;
+    --accent-text: #ffffff;
+  }
+
+  * {
+    box-sizing: border-box;
+    padding: 0;
+    margin: 0;
+  }
+
+  html,
+  body {
+    max-width: 100vw;
+    overflow-x: hidden;
+  }
+
+  body {
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+    background: var(--background);
+    color: var(--text);
+    line-height: 1.6;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+  }
+
+  main {
+    flex: 1;
+  }
+
+  a {
+    color: inherit;
+    text-decoration: none;
+  }
+
+  img {
+    max-width: 100%;
+    height: auto;
+  }
+}
+
+@layer components {
+  .container {
+    width: 100%;
+    max-width: 1120px;
+    margin: 0 auto;
+    padding: 0 1.25rem;
+  }
+
+  .skip-link {
+    position: absolute;
+    left: -9999px;
+  }
+
+  .skip-link:focus {
+    left: 1rem;
+    top: 1rem;
+    padding: 0.5rem 1rem;
+    background: var(--accent);
+    color: var(--accent-text);
+    z-index: 10;
+  }
+
+  .site-header {
+    border-bottom: 1px solid var(--border);
+  }
+
+  .nav {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 1rem;
+    min-height: 4rem;
+  }
+
+  .brand {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    font-weight: 700;
+    font-size: 1.1rem;
+  }
+
+  .nav ul {
+    display: flex;
+    gap: 1.5rem;
+    list-style: none;
+  }
+
+  .nav ul a {
+    color: var(--muted);
+  }
+
+  .nav ul a:hover {
+    color: var(--text);
+  }
+
+  .hero {
+    padding: 6rem 0;
+    background: var(--surface);
+  }
+
+  .hero h1 {
+    font-size: clamp(2.25rem, 6vw, 3.5rem);
+    line-height: 1.1;
+  }
+
+  .lead {
+    margin-top: 1rem;
+    max-width: 40rem;
+    font-size: 1.2rem;
+    color: var(--muted);
+  }
+
+  .actions {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.75rem;
+    margin-top: 2rem;
+  }
+
+  .button {
+    display: inline-block;
+    padding: 0.7rem 1.3rem;
+    border: 1px solid var(--accent);
+    border-radius: 0.5rem;
+    background: var(--accent);
+    color: var(--accent-text);
+    font: inherit;
+    font-weight: 600;
+    cursor: pointer;
+  }
+
+  .button-secondary {
+    background: transparent;
+    color: var(--accent);
+  }
+
+  .page {
+    padding: 4rem 0;
+  }
+
+  .prose h1 {
+    font-size: 2.25rem;
+    line-height: 1.2;
+    margin-bottom: 1rem;
+  }
+
+  .prose p + p {
+    margin-top: 1rem;
+  }
+
+  .prose a:not(.button) {
+    text-decoration: underline;
+  }
+
+  .spinner {
+    width: 2rem;
+    height: 2rem;
+    border: 3px solid var(--border);
+    border-top-color: var(--accent);
+    border-radius: 50%;
+    animation: spin 0.8s linear infinite;
+  }
+
+  .site-footer {
+    padding: 2rem 0;
+    border-top: 1px solid var(--border);
+    color: var(--muted);
+    font-size: 0.9rem;
+  }
+
+  @media (max-width: 640px) {
+    .nav ul {
+      gap: 1rem;
+    }
+
+    .hero {
+      padding: 4rem 0;
+    }
+  }
+}
+
+@keyframes spin {
+  to {
+    transform: rotate(360deg);
+  }
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#0f172a"/><path d="M20 44V20h6l12 15V20h6v24h-6L26 29v15z" fill="#fff"/></svg>

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/layout.tsx

@@ -0,0 +1,66 @@
+import type { Metadata, Viewport } from 'next'
+import { Inter } from 'next/font/google'
+import Footer from '@/components/Footer'
+import Header from '@/components/Header'
+import { SITE_DESCRIPTION, SITE_KEYWORDS, SITE_NAME, SITE_URL } from '@/utils/constants'
+import './globals.css'
+
+const inter = Inter({ subsets: ['latin'] })
+
+// Search-console verification tags only when the codes are set: empty ones are invalid markup.
+const verification: Metadata['verification'] = {}
+if (process.env.NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION) verification.google = process.env.NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION
+if (process.env.NEXT_PUBLIC_BING_SITE_VERIFICATION) verification.other = { 'msvalidate.01': process.env.NEXT_PUBLIC_BING_SITE_VERIFICATION }
+
+export const metadata: Metadata = {
+  metadataBase: new URL(SITE_URL),
+  // Pages set just their own title ("About"); this turns it into "About · Site name".
+  title: { default: SITE_NAME, template: `%s · ${SITE_NAME}` },
+  description: SITE_DESCRIPTION,
+  keywords: SITE_KEYWORDS,
+  applicationName: SITE_NAME,
+  authors: [{ name: SITE_NAME }],
+  creator: SITE_NAME,
+  publisher: SITE_NAME,
+  // The social image is src/app/opengraph-image.tsx; the favicon is src/app/icon.svg.
+  openGraph: {
+    type: 'website',
+    locale: 'en_US',
+    url: SITE_URL,
+    siteName: SITE_NAME,
+    title: SITE_NAME,
+    description: SITE_DESCRIPTION,
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: SITE_NAME,
+    description: SITE_DESCRIPTION,
+  },
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: { index: true, follow: true, 'max-video-preview': -1, 'max-image-preview': 'large', 'max-snippet': -1 },
+  },
+  verification,
+}
+
+export const viewport: Viewport = {
+  themeColor: '#0f172a',
+  width: 'device-width',
+  initialScale: 1,
+}
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    // No <link rel="canonical"> here: in the root layout it would name the home page as the
+    // canonical URL of every page. Each page sets its own with `alternates: { canonical: '/path' }`.
+    <html lang="en">
+      <body className={inter.className}>
+        <a className="skip-link" href="#content">Skip to content</a>
+        <Header />
+        <main id="content">{children}</main>
+        <Footer />
+      </body>
+    </html>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/loading.tsx

@@ -0,0 +1,10 @@
+// Shown while a page's data loads (server components that await).
+export default function Loading() {
+  return (
+    <section className="page" aria-busy="true">
+      <div className="container">
+        <div className="spinner" role="status" aria-label="Loading" />
+      </div>
+    </section>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/manifest.ts

@@ -0,0 +1,16 @@
+import type { MetadataRoute } from 'next'
+import { SITE_DESCRIPTION, SITE_NAME } from '@/utils/constants'
+
+// /manifest.webmanifest: name and icon when the site is added to a phone's home screen.
+export default function manifest(): MetadataRoute.Manifest {
+  return {
+    name: SITE_NAME,
+    short_name: SITE_NAME,
+    description: SITE_DESCRIPTION,
+    start_url: '/',
+    display: 'standalone',
+    background_color: '#ffffff',
+    theme_color: '#0f172a',
+    icons: [{ src: '/icon.svg', sizes: 'any', type: 'image/svg+xml' }],
+  }
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/not-found.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from 'next'
+import Link from 'next/link'
+
+export const metadata: Metadata = {
+  title: 'Page not found',
+  robots: { index: false },
+}
+
+export default function NotFound() {
+  return (
+    <section className="page">
+      <div className="container prose">
+        <h1>Page not found</h1>
+        <p>The page you&apos;re looking for doesn&apos;t exist or has moved.</p>
+        <p><Link className="button" href="/">Back to the home page</Link></p>
+      </div>
+    </section>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/opengraph-image.tsx

@@ -0,0 +1,25 @@
+import { ImageResponse } from 'next/og'
+import { SITE_DESCRIPTION, SITE_NAME } from '@/utils/constants'
+
+// The picture shown when a link to the site is shared (Open Graph / Twitter cards). Generated at
+// build time; replace it with a designed image by putting opengraph-image.png here instead.
+export const alt = SITE_NAME
+export const size = { width: 1200, height: 630 }
+export const contentType = 'image/png'
+
+export default function OpengraphImage() {
+  return new ImageResponse(
+    (
+      <div
+        style={{
+          width: '100%', height: '100%', display: 'flex', flexDirection: 'column', justifyContent: 'center',
+          padding: '80px', background: '#0f172a', color: '#ffffff',
+        }}
+      >
+        <div style={{ fontSize: 80, fontWeight: 700 }}>{SITE_NAME}</div>
+        <div style={{ fontSize: 36, marginTop: 24, color: '#cbd5e1' }}>{SITE_DESCRIPTION}</div>
+      </div>
+    ),
+    size,
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/page.tsx

@@ -0,0 +1,23 @@
+import type { Metadata } from 'next'
+import Link from 'next/link'
+import { SITE_DESCRIPTION, SITE_NAME } from '@/utils/constants'
+
+// No title: the home page uses the site name itself (the layout's default).
+export const metadata: Metadata = {
+  alternates: { canonical: '/' },
+}
+
+export default function Home() {
+  return (
+    <section className="hero">
+      <div className="container">
+        <h1>{SITE_NAME}</h1>
+        <p className="lead">{SITE_DESCRIPTION}</p>
+        <div className="actions">
+          <Link className="button" href="/contact">Get in touch</Link>
+          <Link className="button button-secondary" href="/about">Learn more</Link>
+        </div>
+      </div>
+    </section>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/robots.ts

@@ -0,0 +1,14 @@
+import type { MetadataRoute } from 'next'
+import { SITE_URL } from '@/utils/constants'
+
+// /robots.txt. Outside production (NEXT_PUBLIC_SITE_URL still localhost, a staging host...) set
+// NEXT_PUBLIC_NOINDEX=true so search engines don't index a copy of the site.
+export default function robots(): MetadataRoute.Robots {
+  if (process.env.NEXT_PUBLIC_NOINDEX === 'true') {
+    return { rules: { userAgent: '*', disallow: '/' } }
+  }
+  return {
+    rules: { userAgent: '*', allow: '/' },
+    sitemap: `${SITE_URL}/sitemap.xml`,
+  }
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/app/sitemap.ts

@@ -0,0 +1,12 @@
+import type { MetadataRoute } from 'next'
+import { PAGES, SITE_URL } from '@/utils/constants'
+
+// /sitemap.xml: the pages in PAGES. Pages built from data (articles, products) are added here too,
+// e.g. by fetching their slugs from the API.
+export default function sitemap(): MetadataRoute.Sitemap {
+  return PAGES.map((page) => ({
+    url: `${SITE_URL}${page.path === '/' ? '' : page.path}`,
+    changeFrequency: 'monthly' as const,
+    priority: page.path === '/' ? 1 : 0.7,
+  }))
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/components/Footer.tsx

@@ -0,0 +1,11 @@
+import { SITE_NAME } from '@/utils/constants'
+
+export default function Footer() {
+  return (
+    <footer className="site-footer">
+      <div className="container">
+        © {new Date().getFullYear()} {SITE_NAME}
+      </div>
+    </footer>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/components/Header.tsx

@@ -0,0 +1,24 @@
+import Image from 'next/image'
+import Link from 'next/link'
+import { PAGES, SITE_NAME } from '@/utils/constants'
+
+export default function Header() {
+  return (
+    <header className="site-header">
+      <nav className="container nav" aria-label="Main">
+        {/* Not an <h1>: each page has its own, and a page should have one. */}
+        <Link href="/" className="brand">
+          <Image src="/logo.svg" alt="" width={32} height={32} priority />
+          <span>{SITE_NAME}</span>
+        </Link>
+        <ul>
+          {PAGES.map((page) => (
+            <li key={page.path}>
+              <Link href={page.path}>{page.label}</Link>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </header>
+  )
+}

ntc_dev_kit-1.3.1/ntc/templates/nextjs/src/utils/constants.ts

@@ -0,0 +1,16 @@
+// The ntc Django template serves its API under /api/v1/.
+export const API_BASE_URL = process.env.NEXT_PUBLIC_API_BASE_URL || 'http://localhost:8000/api/v1'
+
+// The site itself: used by the layout's metadata, robots.txt, the sitemap, the manifest and the
+// social image. Set them per environment in .env.local / the deployment's variables.
+export const SITE_NAME = process.env.NEXT_PUBLIC_SITE_NAME || '{project_name}'
+export const SITE_URL = (process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000').replace(/\/$/, '')
+export const SITE_DESCRIPTION = process.env.NEXT_PUBLIC_SITE_DESCRIPTION || 'A modern website built with Next.js'
+export const SITE_KEYWORDS = (process.env.NEXT_PUBLIC_SITE_KEYWORDS || 'nextjs,react,typescript').split(',')
+
+// The pages in the header and the sitemap. Add a page here when you add one under src/app/.
+export const PAGES = [
+  { path: '/', label: 'Home' },
+  { path: '/about', label: 'About' },
+  { path: '/contact', label: 'Contact' },
+]