@tinycld/bootstrap 1.0.0

package/dist/validate.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+const SLUG_RE = /^[a-z][a-z0-9-]*[a-z0-9]$/;
+const RESERVED_SLUGS = new Set(['core', 'main', 'test', 'tests', 'node_modules', 'packages']);
+const SHORTCUT_RE = /^[a-z]$/;
+const ICON_RE = /^[a-z][a-z0-9-]*$/;
+export function validateSlug(slug) {
+    if (!slug || slug.length < 3)
+        return 'Slug must be at least 3 characters';
+    if (slug.length > 40)
+        return 'Slug must be 40 characters or fewer';
+    if (!SLUG_RE.test(slug)) {
+        return 'Slug must be kebab-case (lowercase letters, digits, hyphens; no leading/trailing hyphen)';
+    }
+    if (RESERVED_SLUGS.has(slug))
+        return `"${slug}" is reserved`;
+    return null;
+}
+export function validateName(name) {
+    if (!name || name.trim().length === 0)
+        return 'Name is required';
+    if (name.length > 60)
+        return 'Name must be 60 characters or fewer';
+    return null;
+}
+export function validateDescription(desc) {
+    if (!desc || desc.trim().length === 0)
+        return 'Description is required';
+    if (desc.length > 200)
+        return 'Description must be 200 characters or fewer';
+    return null;
+}
+export function validateIcon(icon) {
+    if (!icon || icon.length === 0)
+        return null; // optional
+    if (!ICON_RE.test(icon))
+        return 'Icon must be a lucide-react-native name (lowercase, hyphens)';
+    return null;
+}
+export function validateNavOrder(raw) {
+    const n = Number(raw);
+    if (!Number.isInteger(n))
+        return 'Nav order must be an integer';
+    if (n < 0 || n > 99)
+        return 'Nav order must be between 0 and 99';
+    return null;
+}
+export function validateShortcut(s) {
+    if (!s || s.length === 0)
+        return null; // optional
+    if (!SHORTCUT_RE.test(s))
+        return 'Shortcut must be a single lowercase letter';
+    return null;
+}
+export function validateTargetDir(dir) {
+    if (!existsSync(dir))
+        return null;
+    const stat = statSync(dir);
+    if (!stat.isDirectory())
+        return `${dir} exists and is not a directory`;
+    const entries = readdirSync(dir).filter((n) => n !== '.DS_Store');
+    if (entries.length > 0)
+        return `${dir} exists and is not empty`;
+    return null;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "@tinycld/bootstrap",
+    "version": "1.0.0",
+    "description": "Scaffolder for @tinycld feature packages",
+    "type": "module",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/tinycld/bootstrap.git"
+    },
+    "bin": {
+        "bootstrap": "dist/index.js"
+    },
+    "files": [
+        "dist",
+        "templates"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx src/index.ts",
+        "lint": "biome check .",
+        "lint:fix": "biome check --write .",
+        "typecheck": "tsc --noEmit",
+        "checks": "npm run lint && npm run typecheck",
+        "test": "vitest run",
+        "prepublishOnly": "npm run checks && npm run test && npm run build",
+        "release": "npm publish"
+    },
+    "dependencies": {
+        "@clack/prompts": "^0.8.0",
+        "picocolors": "^1.1.0"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "^2.4.12",
+        "@types/node": "^22.10.0",
+        "tsx": "^4.21.0",
+        "typescript": "^5.9.0",
+        "vitest": "^3.0.0"
+    },
+    "engines": {
+        "node": ">=24"
+    }
+}

package/templates/full/manifest.ts

@@ -0,0 +1,21 @@
+const manifest = {
+    name: '{{PKG_NAME}}',
+    slug: '{{PKG_SLUG}}',
+    version: '0.1.0',
+    description: '{{PKG_DESCRIPTION}}',
+    routes: { directory: 'screens' },
+    nav: {
+        label: '{{PKG_NAME}}',
+        icon: '{{PKG_ICON}}',
+        order: {{PKG_NAV_ORDER}},
+        shortcut: '{{PKG_NAV_SHORTCUT}}',
+    },
+    sidebar: { component: 'sidebar' },
+    provider: { component: 'provider' },
+    migrations: { directory: 'pb-migrations' },
+    collections: { register: 'collections', types: 'types' },
+    seed: { script: 'seed' },
+    server: { package: 'server', module: '{{GO_MODULE}}' },
+}
+
+export default manifest

package/templates/full/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "@tinycld/{{PKG_SLUG}}",
+    "version": "0.1.0",
+    "private": true,
+    "type": "module",
+    "description": "{{PKG_DESCRIPTION}}",
+    "exports": {
+        "./package.json": "./package.json",
+        "./manifest": "./manifest.ts",
+        "./types": "./tinycld/{{PKG_SLUG}}/types.ts",
+        "./collections": "./tinycld/{{PKG_SLUG}}/collections.ts",
+        "./screens/*": "./tinycld/{{PKG_SLUG}}/screens/*.tsx",
+        "./seed": "./tinycld/{{PKG_SLUG}}/seed.ts",
+        "./sidebar": "./tinycld/{{PKG_SLUG}}/sidebar.tsx",
+        "./provider": "./tinycld/{{PKG_SLUG}}/provider.tsx",
+        "./hooks/*": "./tinycld/{{PKG_SLUG}}/hooks/*.ts",
+        "./components/*": "./tinycld/{{PKG_SLUG}}/components/*.tsx"
+    },
+    "scripts": {
+        "typecheck": "tsc --noEmit --skipLibCheck"
+    },
+    "peerDependencies": {
+        "react": ">=19",
+        "react-native": ">=0.83",
+        "expo-router": ">=55.0.0",
+        "pbtsdb": ">=0.5",
+        "@tanstack/react-db": ">=0.1",
+        "@tanstack/db": ">=0.6"
+    }
+}

package/templates/full/pb-migrations/1800000000_create_{{PKG_SLUG}}.js

@@ -0,0 +1,67 @@
+/// <reference path="../pb_data/types.d.ts" />
+
+// Initial migration for {{PKG_SLUG}}. Creates a single `{{PKG_SNAKE}}_items`
+// collection matching the shape declared in types.ts / collections.ts.
+// Replace or extend this as you build out the package.
+//
+// Auth rules: every TinyCld collection ships with rules. Without them
+// PocketBase falls back to "superusers only" and every insert/select fails
+// with "Only superusers can perform this action." The rules below assume an
+// org-scoped data model — each row has an `owner` relation pointing at a
+// user_org row, and the rule allows access when the calling user owns that
+// user_org. This matches the pattern used by @tinycld/contacts and friends.
+//
+// If your data isn't org-scoped (user-scoped, public, anything else), pick
+// the right rule pattern from the docs:
+//   https://tinycld.org/docs/tasks/auth-rules
+
+migrate(
+    app => {
+        const collection = new Collection({
+            type: 'base',
+            name: '{{PKG_SNAKE}}_items',
+            listRule: 'owner.user = @request.auth.id',
+            viewRule: 'owner.user = @request.auth.id',
+            createRule: 'owner.user = @request.auth.id',
+            updateRule: 'owner.user = @request.auth.id',
+            deleteRule: 'owner.user = @request.auth.id',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'text',
+                    required: true,
+                    min: 1,
+                    max: 200,
+                },
+                {
+                    name: 'owner',
+                    type: 'relation',
+                    required: true,
+                    collectionId: 'pbc_user_org_01',
+                    cascadeDelete: true,
+                    maxSelect: 1,
+                },
+                {
+                    name: 'created',
+                    type: 'autodate',
+                    onCreate: true,
+                    onUpdate: false,
+                },
+                {
+                    name: 'updated',
+                    type: 'autodate',
+                    onCreate: true,
+                    onUpdate: true,
+                },
+            ],
+            indexes: [
+                'CREATE INDEX `idx_{{PKG_SNAKE}}_items_owner` ON `{{PKG_SNAKE}}_items` (`owner`)',
+            ],
+        })
+        app.save(collection)
+    },
+    app => {
+        const collection = app.findCollectionByNameOrId('{{PKG_SNAKE}}_items')
+        app.delete(collection)
+    }
+)

package/templates/full/server/go.mod

@@ -0,0 +1,10 @@
+module {{GO_MODULE}}
+
+go 1.25.0
+
+require (
+	github.com/pocketbase/pocketbase v0.36.8
+	tinycld.org/core v0.0.0
+)
+
+replace tinycld.org/core => ../../tinycld/packages/@tinycld/core/server

package/templates/full/server/register.go

@@ -0,0 +1,20 @@
+package {{PKG_CAMEL}}
+
+import (
+	"github.com/pocketbase/pocketbase"
+)
+
+// Register wires server-side hooks for the {{PKG_NAME}} package. Core's
+// generator injects a call to this function from `server/package_extensions.go`
+// once the package is linked.
+//
+// Typical responsibilities:
+//   - Register audit hooks for your collections (see tinycld.org/core/audit).
+//   - Bind record lifecycle hooks via `app.OnRecordCreate("...").BindFunc(...)`.
+//   - Register HTTP endpoints via `app.OnServe().BindFunc(...)`.
+//
+// See contacts/server/register.go or calendar/server/register.go for richer
+// examples.
+func Register(_ *pocketbase.PocketBase) {
+	// No server-side logic yet.
+}

package/templates/full/tinycld/{{PKG_SLUG}}/collections.ts

@@ -0,0 +1,27 @@
+import type { CoreStores } from '@tinycld/core/lib/pocketbase'
+import type { Schema } from '@tinycld/core/types/pbSchema'
+import type { createCollection } from 'pbtsdb/core'
+import { BasicIndex } from 'pbtsdb/core'
+import type { {{PKG_PASCAL}}Schema } from './types'
+
+type MergedSchema = Schema & {{PKG_PASCAL}}Schema
+
+// Collections contributed by this package. Core calls this during pbtsdb
+// bootstrap; the returned object's keys become top-level keys on the app's
+// MergedSchema (accessible via `useStore('...')`).
+export function registerCollections(
+    newCollection: ReturnType<typeof createCollection<MergedSchema>>,
+    _core: CoreStores
+) {
+    const {{PKG_SNAKE}}_items = newCollection('{{PKG_SNAKE}}_items', {
+        omitOnInsert: ['created', 'updated'] as const,
+        collectionOptions: {
+            autoIndex: 'eager' as const,
+            defaultIndexType: BasicIndex,
+        },
+    })
+
+    return {
+        {{PKG_SNAKE}}_items,
+    }
+}

package/templates/full/tinycld/{{PKG_SLUG}}/provider.tsx

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react'
+
+// Optional context provider mounted by core inside /a/[orgSlug]/{{PKG_SLUG}}.
+// Wrap any package-specific context providers or run mount-time side
+// effects (e.g. subscribing to events, prefetching queries) here.
+//
+// If you don't need a provider, delete this file and remove the
+// `provider` field from manifest.ts.
+
+interface Props {
+    children: ReactNode
+}
+
+export default function {{PKG_PASCAL}}Provider({ children }: Props) {
+    return <>{children}</>
+}

package/templates/full/tinycld/{{PKG_SLUG}}/screens/[id].tsx

@@ -0,0 +1,23 @@
+import { useThemeColor } from '@tinycld/core/lib/use-app-theme'
+import { useLocalSearchParams } from 'expo-router'
+import { Text, View } from 'react-native'
+
+// Dynamic detail route. Wired automatically by core's generator to
+// /a/<orgSlug>/{{PKG_SLUG}}/<id>.
+//
+// To navigate back to the index or to another org-scoped screen, use
+// `useOrgHref()` from `@tinycld/core/lib/org-routes`. See
+// https://tinycld.org/docs/tasks/routing
+
+export default function {{PKG_PASCAL}}Detail() {
+    const { id } = useLocalSearchParams<{ id: string }>()
+    const fg = useThemeColor('foreground')
+    const muted = useThemeColor('muted-foreground')
+
+    return (
+        <View className="p-6 gap-3">
+            <Text style={{ color: fg, fontSize: 22, fontWeight: '600' }}>{{PKG_NAME}} detail</Text>
+            <Text style={{ color: muted, fontSize: 14 }}>Showing item {id}</Text>
+        </View>
+    )
+}

package/templates/full/tinycld/{{PKG_SLUG}}/screens/_layout.tsx

@@ -0,0 +1,5 @@
+import { Stack } from 'expo-router'
+
+export default function {{PKG_PASCAL}}Layout() {
+    return <Stack screenOptions={{ headerShown: false }} />
+}

package/templates/full/tinycld/{{PKG_SLUG}}/screens/index.tsx

@@ -0,0 +1,28 @@
+import { useThemeColor } from '@tinycld/core/lib/use-app-theme'
+import { ScrollView, Text, View } from 'react-native'
+
+// Org-scoped index route for {{PKG_NAME}}, served at /a/<orgSlug>/{{PKG_SLUG}}.
+// Replace this placeholder with your list view (cards, table, whatever you
+// need) and wire it to your pbtsdb collections using `useOrgLiveQuery`.
+//
+// For navigation, use `useOrgHref()` from `@tinycld/core/lib/org-routes` —
+// never literal paths like `router.push('/{{PKG_SLUG}}/new')`, which drop
+// the org segment. See https://tinycld.org/docs/tasks/routing
+//
+//   const orgHref = useOrgHref()
+//   router.push(orgHref('{{PKG_SLUG}}/new'))
+//   router.push(orgHref('{{PKG_SLUG}}/[id]', { id: itemId }))
+
+export default function {{PKG_PASCAL}}Index() {
+    const fg = useThemeColor('foreground')
+    const muted = useThemeColor('muted-foreground')
+
+    return (
+        <ScrollView className="flex-1 bg-background">
+            <View className="p-6 gap-3">
+                <Text style={{ color: fg, fontSize: 22, fontWeight: '600' }}>{{PKG_NAME}}</Text>
+                <Text style={{ color: muted, fontSize: 14 }}>Placeholder landing screen for {{PKG_SLUG}}.</Text>
+            </View>
+        </ScrollView>
+    )
+}

package/templates/full/tinycld/{{PKG_SLUG}}/seed.ts

@@ -0,0 +1,22 @@
+import type PocketBase from 'pocketbase'
+
+// Seed function invoked by core/scripts/seed-db.ts for the primary test org.
+// Receives the authenticated `pb` client plus the user/org/user_org context
+// so records can be owned correctly. Return nothing; throw to abort the seed.
+//
+// Example:
+//
+//     await pb.collection('{{PKG_SNAKE}}_items').create({
+//         name: 'Sample',
+//         owner: userOrg.id,
+//     })
+
+interface SeedContext {
+    user: { id: string; email: string; name: string }
+    org: { id: string }
+    userOrg: { id: string }
+}
+
+export default async function seed(_pb: PocketBase, _ctx: SeedContext): Promise<void> {
+    // Add your sample data here.
+}

package/templates/full/tinycld/{{PKG_SLUG}}/sidebar.tsx

@@ -0,0 +1,20 @@
+import { useThemeColor } from '@tinycld/core/lib/use-app-theme'
+import { Text, View } from 'react-native'
+
+// Sidebar for the {{PKG_NAME}} package. Rendered in the workspace drawer
+// when a user is on any /a/<orgSlug>/{{PKG_SLUG}}/... route.
+//
+// Replace with real navigation (folders, favorites, filters, etc). See
+// @tinycld/calendar or @tinycld/mail sidebars for richer examples.
+
+export default function {{PKG_PASCAL}}Sidebar() {
+    const fg = useThemeColor('foreground')
+    const muted = useThemeColor('muted-foreground')
+
+    return (
+        <View className="p-3 gap-2">
+            <Text style={{ color: fg, fontSize: 14, fontWeight: '600' }}>{{PKG_NAME}}</Text>
+            <Text style={{ color: muted, fontSize: 12 }}>Replace this with your package's sidebar nav.</Text>
+        </View>
+    )
+}

package/templates/full/tinycld/{{PKG_SLUG}}/types.ts

@@ -0,0 +1,18 @@
+// Schema types for this package, merged into core's MergedSchema by the
+// generator. Each entry maps a pbtsdb collection name to its record type
+// and optional relations. Rename, replace, or delete {{PKG_SNAKE}}_items
+// when you wire up your first real collection.
+
+export interface {{PKG_PASCAL}}Item {
+    id: string
+    name: string
+    owner: string
+    created: string
+    updated: string
+}
+
+export type {{PKG_PASCAL}}Schema = {
+    {{PKG_SNAKE}}_items: {
+        type: {{PKG_PASCAL}}Item
+    }
+}

package/templates/settings-only/manifest.ts

@@ -0,0 +1,15 @@
+const manifest = {
+    name: '{{PKG_NAME}}',
+    slug: '{{PKG_SLUG}}',
+    version: '0.1.0',
+    description: '{{PKG_DESCRIPTION}}',
+    settings: [
+        {
+            slug: '{{PKG_SLUG}}',
+            component: 'settings/main',
+            label: '{{PKG_NAME}}',
+        },
+    ],
+}
+
+export default manifest

package/templates/settings-only/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "@tinycld/{{PKG_SLUG}}",
+    "version": "0.1.0",
+    "private": true,
+    "type": "module",
+    "description": "{{PKG_DESCRIPTION}}",
+    "exports": {
+        "./package.json": "./package.json",
+        "./manifest": "./manifest.ts",
+        "./types": "./tinycld/{{PKG_SLUG}}/types.ts",
+        "./settings/*": "./tinycld/{{PKG_SLUG}}/settings/*.tsx",
+        "./components/*": "./tinycld/{{PKG_SLUG}}/components/*.tsx",
+        "./hooks/*": "./tinycld/{{PKG_SLUG}}/hooks/*.ts"
+    },
+    "scripts": {
+        "typecheck": "tsc --noEmit --skipLibCheck"
+    },
+    "peerDependencies": {
+        "react": ">=19",
+        "react-native": ">=0.83",
+        "expo-router": ">=55.0.0"
+    }
+}

package/templates/settings-only/tinycld/{{PKG_SLUG}}/settings/main.tsx

@@ -0,0 +1,20 @@
+import { useThemeColor } from '@tinycld/core/lib/use-app-theme'
+import { ScrollView, Text, View } from 'react-native'
+
+// The settings panel for {{PKG_NAME}}. Mounted by core inside
+// /a/<orgSlug>/settings/{{PKG_SLUG}}/{{PKG_SLUG}} via the manifest's
+// `settings[]` entry. This is the only screen the package contributes.
+
+export default function {{PKG_PASCAL}}Settings() {
+    const fg = useThemeColor('foreground')
+    const muted = useThemeColor('muted-foreground')
+
+    return (
+        <ScrollView className="flex-1 bg-background">
+            <View className="p-6 gap-3">
+                <Text style={{ color: fg, fontSize: 22, fontWeight: '600' }}>{{PKG_NAME}}</Text>
+                <Text style={{ color: muted, fontSize: 14 }}>{{PKG_DESCRIPTION}}</Text>
+            </View>
+        </ScrollView>
+    )
+}

package/templates/settings-only/tinycld/{{PKG_SLUG}}/types.ts

@@ -0,0 +1,5 @@
+// This package contributes only a settings panel — no pbtsdb collections,
+// no schema extension. Keep this file for public type exports if any
+// other package ever needs to import from {{PKG_SLUG}}.
+
+export {}

package/templates/shared/.github/workflows/ci.yml

@@ -0,0 +1,59 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  APP_REPO: tinycld/tinycld
+  APP_REF: main
+
+jobs:
+  checks:
+    name: Lint, typecheck, unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          path: {{PKG_SLUG}}
+      - uses: actions/checkout@v5
+        with:
+          repository: ${{ env.APP_REPO }}
+          ref: ${{ env.APP_REF }}
+          path: tinycld
+      - uses: actions/setup-node@v5
+        with:
+          node-version-file: tinycld/.node-version
+          cache: npm
+          cache-dependency-path: tinycld/package-lock.json
+
+      # The app shell bundles @tinycld/core at packages/@tinycld/core/. This
+      # package's tsconfig path "@tinycld/core/*":
+      # ["../tinycld/packages/@tinycld/core/*"] and its server go.mod replace
+      # directive both point directly there.
+      - name: Install app shell deps
+        working-directory: tinycld
+        run: npm ci
+
+      - name: Link {{PKG_SLUG}} into tinycld app shell
+        working-directory: tinycld
+        run: npm run packages:link ../{{PKG_SLUG}}
+
+      - name: Lint (biome lives in tinycld and lints linked {{PKG_SLUG}} via app rules)
+        working-directory: tinycld
+        run: npm run lint
+
+      # Typecheck runs from inside tinycld so module resolution sees the
+      # full app-shell tree (uniwind augments, expo types, etc) — running
+      # tsc standalone in the package directory misses those.
+      - name: Typecheck (full app shell, package included via link)
+        working-directory: tinycld
+        env:
+          NODE_OPTIONS: --preserve-symlinks
+        run: npm run typecheck
+
+      - name: Run unit tests
+        working-directory: {{PKG_SLUG}}
+        run: npx vitest run

package/templates/shared/README.md

@@ -0,0 +1,54 @@
+# {{PKG_SLUG}}
+
+{{PKG_DESCRIPTION}}
+
+Feature package for the [tinycld](https://github.com/tinycld/tinycld) ecosystem. Lives as a standalone git repo alongside the [`tinycld`](https://github.com/tinycld/tinycld) app shell and other sibling packages (`contacts`, `mail`, `calendar`, `drive`, `google-takeout-import`). The app shell bundles `@tinycld/core` inside it — there is no separate core repo to clone.
+
+## Development
+
+```sh
+# Clone the app shell and this package as siblings
+cd ~/code/tinycld
+git clone git@github.com:tinycld/tinycld.git
+git clone git@github.com:tinycld/{{PKG_SLUG}}.git
+
+# Install deps in the app shell
+cd tinycld
+npm install
+
+# Link this package into the app shell
+npm run packages:link ../{{PKG_SLUG}}
+
+# Run the full stack
+npm run start
+```
+
+## Standalone checks
+
+Lint and typecheck both run from the app shell — biome and TypeScript live
+there, and the app shell's tsconfig pulls in `expo`'s base config, `uniwind`
+type augments, and the live `~/types/pbSchema` generated from PocketBase,
+none of which a standalone invocation in this package can see. Biome's
+config lives in `tinycld/biome.json` and applies to every linked package
+(there is no `biome.json` in this repo).
+
+```sh
+cd ../tinycld
+npm run packages:link ../{{PKG_SLUG}}   # only needed once per checkout
+npm run lint                            # scans this package via the app's biome rules
+npm run typecheck                       # full app-shell tsc
+```
+
+## CI
+
+`.github/workflows/ci.yml` runs lint, typecheck, and vitest on every push to
+`main` and every PR. It clones `tinycld/tinycld@main` into a sibling
+directory, installs the app shell's deps, links this package in, and runs
+the checks — exactly what a developer does locally.
+
+## Package anatomy
+
+- `manifest.ts` — the single source of truth for this package's capabilities
+- `package.json` — name, exports map, peer deps
+- `tsconfig.json` — typecheck config (lint config lives in the app shell's `biome.json`)
+- `tests/` — vitest unit tests

package/templates/shared/tests/manifest.test.ts

@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest'
+import manifest from '../manifest'
+
+describe('{{PKG_SLUG}} manifest', () => {
+    it('declares required identifiers', () => {
+        expect(manifest.name).toBe('{{PKG_NAME}}')
+        expect(manifest.slug).toBe('{{PKG_SLUG}}')
+        expect(manifest.version).toMatch(/^\d+\.\d+\.\d+/)
+    })
+
+    it('has a description', () => {
+        expect(manifest.description).toBe('{{PKG_DESCRIPTION}}')
+    })
+})