@basicbenframework/core 0.1.0 → 0.1.5

package/.github/workflows/publish.yml

@@ -20,16 +20,15 @@ jobs:
           node-version: '24'
           registry-url: 'https://registry.npmjs.org'
 
+      - name: Install test dependencies
+        run: npm install better-sqlite3
+
       - name: Run tests
         run: npm test
 
       - name: Publish @basicbenframework/core
         run: npm publish --access public --provenance
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-      - name: Publish create-basicben-app
+      - name: Publish @basicbenframework/create
         working-directory: ./create-basicben-app
         run: npm publish --access public --provenance
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

@@ -0,0 +1,9 @@
+The MIT License
+
+Copyright (c) 2025 Ling Chi Tao (@ctmakes)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -35,7 +35,7 @@ Most JS frameworks make one of two mistakes: they do too much (Next.js, Remix) o
 ## Quick Start
 
 ```bash
-npx create-basicben-app my-app
+npx @basicbenframework/create my-app
 cd my-app
 npm install
 npx basicben migrate
@@ -49,10 +49,10 @@ Your app is running at `http://localhost:3000` with a fully functional blog app
 To develop against a local copy of the framework:
 
 ```bash
-npx create-basicben-app my-app --local
+npx @basicbenframework/create my-app --local
 ```
 
-This sets the `basicben` dependency to `file:../basicben-framework` instead of fetching from npm.
+This sets the `basicben` dependency to `file:../core` instead of fetching from npm.
 
 ---
 
@@ -567,8 +567,8 @@ BasicBen has **zero runtime dependencies**:
 BasicBen is early. Contributions, issues, and ideas are welcome.
 
 ```bash
-git clone https://github.com/BasicBenFramework/basicben-framework
-cd basicben-framework
+git clone https://github.com/BasicBenFramework/core
+cd core
 npm install
 npm run dev
 ```

package/create-basicben-app/index.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 
 /**
- * create-basicben-app
+ * @basicbenframework/create
  *
  * Scaffolds a new BasicBen project with the recommended structure.
  *
  * Usage:
- *   npx create-basicben-app my-app
- *   npx create-basicben-app my-app --template minimal
+ *   npx @basicbenframework/create my-app
+ *   npx @basicbenframework/create my-app --template minimal
  */
 
 import { mkdirSync, writeFileSync, copyFileSync, readdirSync, statSync, existsSync } from 'node:fs'
@@ -43,7 +43,7 @@ async function main() {
 
   if (!projectName || projectName.startsWith('-')) {
     console.error(`\n${red('Error:')} Please provide a project name.\n`)
-    console.log(`  ${cyan('npx create-basicben-app')} ${dim('<project-name>')}\n`)
+    console.log(`  ${cyan('npx @basicbenframework/create')} ${dim('<project-name>')}\n`)
     process.exit(1)
   }
 
@@ -150,18 +150,18 @@ VITE_PORT=3000         # Frontend dev server
  */
 function showHelp() {
   console.log(`
-${bold('create-basicben-app')} - Create a new BasicBen project
+${bold('@basicbenframework/create')} - Create a new BasicBen project
 
 ${bold('Usage:')}
-  npx create-basicben-app ${dim('<project-name>')} [options]
+  npx @basicbenframework/create ${dim('<project-name>')} [options]
 
 ${bold('Options:')}
   --local        Use local framework (for development)
   -h, --help     Show this help message
 
 ${bold('Examples:')}
-  npx create-basicben-app my-app
-  npx create-basicben-app my-app --local   ${dim('# Use local framework')}
+  npx @basicbenframework/create my-app
+  npx @basicbenframework/create my-app --local   ${dim('# Use local framework')}
 `)
 }
 
@@ -176,7 +176,9 @@ function copyDir(src, dest) {
 
   for (const entry of entries) {
     const srcPath = join(src, entry.name)
-    const destPath = join(dest, entry.name)
+    // Rename gitignore to .gitignore (npm strips dotfiles during publish)
+    const destName = entry.name === 'gitignore' ? '.gitignore' : entry.name
+    const destPath = join(dest, destName)
 
     if (entry.isDirectory()) {
       copyDir(srcPath, destPath)

package/create-basicben-app/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "create-basicben-app",
-  "version": "0.1.0",
+  "name": "@basicbenframework/create",
+  "version": "0.1.5",
   "description": "Create a new BasicBen application",
   "type": "module",
   "bin": {
-    "create-basicben-app": "./index.js"
+    "create-basicben": "./index.js"
   },
   "files": [
     "index.js",
@@ -22,7 +22,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/BasicBenFramework/basicben-framework"
+    "url": "https://github.com/BasicBenFramework/core"
   },
   "engines": {
     "node": ">=24.14.0"

package/create-basicben-app/template/README.md

@@ -1,6 +1,6 @@
 # My BasicBen App
 
-Built with [BasicBen](https://github.com/BasicBenFramework/basicben-framework) — a full-stack React framework with zero runtime dependencies.
+Built with [BasicBen](https://github.com/BasicBenFramework/core) — a full-stack React framework with zero runtime dependencies.
 
 ## Getting Started
 
@@ -56,4 +56,4 @@ Edit `basicben.config.js` to customize server settings, CORS, database, and more
 
 ## Documentation
 
-Full documentation: [github.com/BasicBenFramework/basicben-framework](https://github.com/BasicBenFramework/basicben-framework)
+Full documentation: [github.com/BasicBenFramework/core](https://github.com/BasicBenFramework/core)

package/create-basicben-app/template/gitignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Database
+*.db
+*.sqlite
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Test coverage
+coverage/

package/create-basicben-app/template/src/client/pages/GettingStarted.jsx

@@ -41,7 +41,7 @@ export function GettingStarted() {
           <h2 className="text-lg font-semibold mb-4">Quick Start</h2>
           <div className={`rounded-lg p-4 font-mono text-sm ${t.card} border ${t.border} overflow-x-auto`}>
             <div className={t.muted}># Create a new project</div>
-            <div>npx create-basicben-app my-app</div>
+            <div>npx @basicbenframework/create my-app</div>
             <div className="mt-2" />
             <div className={t.muted}># Navigate to the project</div>
             <div>cd my-app</div>
@@ -107,7 +107,7 @@ export function GettingStarted() {
           <h2 className="text-lg font-semibold mb-4">Resources</h2>
           <div className="flex flex-wrap gap-3">
             <a
-              href="https://github.com/BasicBenFramework/basicben-framework"
+              href="https://github.com/BasicBenFramework/core"
               target="_blank"
               rel="noopener noreferrer"
               className={`inline-flex items-center gap-2 px-4 py-2 rounded-lg ${t.btnSecondary} transition text-sm`}

package/create-basicben-app/template/src/client/pages/Home.jsx

@@ -81,11 +81,11 @@ export function Home() {
         </p>
         <div className="flex flex-col items-center gap-4">
           <div className={`px-4 py-3 rounded-lg ${t.card} border ${t.border} font-mono text-sm`}>
-            <span className={t.muted}>$</span> npx create-basicben-app my-app
+            <span className={t.muted}>$</span> npx @basicbenframework/create my-app
           </div>
           <div className="flex gap-3">
             <Button onClick={() => navigate('/docs')}>Get Started</Button>
-            <Button variant="secondary" onClick={() => window.open('https://github.com/BasicBenFramework/basicben-framework', '_blank')}>
+            <Button variant="secondary" onClick={() => window.open('https://github.com/BasicBenFramework/core', '_blank')}>
               GitHub
             </Button>
           </div>

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@basicbenframework/core",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "description": "A full-stack framework for React. Minimal dependencies, maximum clarity.",
   "author": "ctmakes",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BasicBenFramework/basicben-framework.git"
+    "url": "git+https://github.com/BasicBenFramework/core.git"
   },
-  "homepage": "https://github.com/BasicBenFramework/basicben-framework#readme",
+  "homepage": "https://github.com/BasicBenFramework/core#readme",
   "bugs": {
-    "url": "https://github.com/BasicBenFramework/basicben-framework/issues"
+    "url": "https://github.com/BasicBenFramework/core/issues"
   },
   "type": "module",
   "bin": {
@@ -34,7 +34,8 @@
     "test:server": "node --test src/server/**/*.test.js",
     "test:cli": "node --test src/cli/**/*.test.js",
     "test:scaffolding": "node --test src/scaffolding/**/*.test.js",
-    "test:app": "./scripts/test-app.sh"
+    "test:app": "./scripts/test-app.sh",
+    "release": "./scripts/publish.sh"
   },
   "keywords": [
     "react",
@@ -44,18 +45,17 @@
     "minimal"
   ],
   "license": "MIT",
-  "dependencies": {},
   "peerDependencies": {
+    "@vitejs/plugin-react": ">=5",
     "react": ">=18",
     "react-dom": ">=18",
-    "vite": ">=7",
-    "@vitejs/plugin-react": ">=5"
+    "vite": ">=7"
   },
   "optionalDependencies": {
-    "better-sqlite3": ">=12",
-    "pg": ">=8",
     "@libsql/client": ">=0.17",
+    "@neondatabase/serverless": ">=1.0",
     "@planetscale/database": ">=1",
-    "@neondatabase/serverless": ">=1.0"
+    "better-sqlite3": "^12.6.2",
+    "pg": ">=8"
   }
 }

package/scripts/publish.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Get the script directory and project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$ROOT_DIR"
+
+# Get current version
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+
+echo -e "${YELLOW}Current version: ${NC}$CURRENT_VERSION"
+echo ""
+
+# Get new version from argument or prompt
+if [ -n "$1" ]; then
+  NEW_VERSION="$1"
+else
+  echo "Enter new version (or press enter for options):"
+  read -r NEW_VERSION
+
+  if [ -z "$NEW_VERSION" ]; then
+    echo ""
+    echo "Version bump options:"
+    echo "  1) patch (x.x.X)"
+    echo "  2) minor (x.X.0)"
+    echo "  3) major (X.0.0)"
+    echo ""
+    read -p "Select [1-3]: " BUMP_TYPE
+
+    IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
+
+    case $BUMP_TYPE in
+      1) NEW_VERSION="$MAJOR.$MINOR.$((PATCH + 1))" ;;
+      2) NEW_VERSION="$MAJOR.$((MINOR + 1)).0" ;;
+      3) NEW_VERSION="$((MAJOR + 1)).0.0" ;;
+      *) echo -e "${RED}Invalid option${NC}"; exit 1 ;;
+    esac
+  fi
+fi
+
+# Validate semver format
+if ! [[ "$NEW_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo -e "${RED}Error: Invalid version format. Use semver (e.g., 1.2.3)${NC}"
+  exit 1
+fi
+
+echo ""
+echo -e "${YELLOW}Publishing version: ${NC}$NEW_VERSION"
+echo ""
+
+# Confirm
+read -p "Continue? [y/N] " CONFIRM
+if [[ ! "$CONFIRM" =~ ^[Yy]$ ]]; then
+  echo "Aborted."
+  exit 0
+fi
+
+echo ""
+
+# Check for uncommitted changes
+if ! git diff --quiet || ! git diff --cached --quiet; then
+  echo -e "${RED}Error: You have uncommitted changes. Please commit or stash them first.${NC}"
+  exit 1
+fi
+
+# Check we're on main branch
+CURRENT_BRANCH=$(git branch --show-current)
+if [ "$CURRENT_BRANCH" != "main" ]; then
+  echo -e "${YELLOW}Warning: You're on branch '$CURRENT_BRANCH', not 'main'.${NC}"
+  read -p "Continue anyway? [y/N] " CONFIRM
+  if [[ ! "$CONFIRM" =~ ^[Yy]$ ]]; then
+    echo "Aborted."
+    exit 0
+  fi
+fi
+
+# Update version in root package.json
+echo -e "${GREEN}Updating version in package.json...${NC}"
+node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+pkg.version = '$NEW_VERSION';
+fs.writeFileSync('./package.json', JSON.stringify(pkg, null, 2) + '\n');
+"
+
+# Update version in create-basicben-app/package.json
+echo -e "${GREEN}Updating version in create-basicben-app/package.json...${NC}"
+node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('./create-basicben-app/package.json', 'utf8'));
+pkg.version = '$NEW_VERSION';
+fs.writeFileSync('./create-basicben-app/package.json', JSON.stringify(pkg, null, 2) + '\n');
+"
+
+# Commit
+echo -e "${GREEN}Committing changes...${NC}"
+git add package.json create-basicben-app/package.json
+git commit -m "v$NEW_VERSION"
+
+# Tag
+echo -e "${GREEN}Creating tag v$NEW_VERSION...${NC}"
+git tag "v$NEW_VERSION"
+
+# Push
+echo -e "${GREEN}Pushing to origin...${NC}"
+git push origin "$CURRENT_BRANCH" --tags
+
+echo ""
+echo -e "${GREEN}✓ Done!${NC}"
+echo ""
+echo "GitHub Actions will now:"
+echo "  1. Run tests"
+echo "  2. Publish @basicbenframework/core"
+echo "  3. Publish @basicbenframework/create"
+echo ""
+echo "Watch the workflow at:"
+echo "  https://github.com/BasicBenFramework/core/actions"

package/my-test-app/.env.example

@@ -1,24 +0,0 @@
-# Application
-APP_KEY=your-secret-key-here
-
-# Server Ports
-PORT=3001              # API server
-VITE_PORT=3000         # Frontend dev server
-
-# Database - uncomment ONE of the following:
-
-# SQLite (default)
-DATABASE_URL=./database.sqlite
-
-# PostgreSQL
-# DATABASE_URL=postgres://user:pass@localhost:5432/mydb
-
-# Turso (edge SQLite)
-# TURSO_URL=libsql://your-db-name.turso.io
-# TURSO_AUTH_TOKEN=your-auth-token
-
-# PlanetScale (serverless MySQL)
-# DATABASE_URL=mysql://user:pass@host/database?ssl={"rejectUnauthorized":true}
-
-# Neon (serverless Postgres)
-# DATABASE_URL=postgres://user:pass@ep-cool-name.us-east-2.aws.neon.tech/mydb?sslmode=require

package/my-test-app/README.md

@@ -1,59 +0,0 @@
-# My BasicBen App
-
-Built with [BasicBen](https://github.com/BasicBenFramework/basicben-framework) — a full-stack React framework with zero runtime dependencies.
-
-## Getting Started
-
-```bash
-npm install
-npm run dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) to view your app.
-
-## Commands
-
-```bash
-npm run dev          # Start development server
-npm run build        # Build for production
-npm run start        # Run production server
-npm run test         # Run tests
-
-npm run migrate      # Run database migrations
-npm run migrate:fresh   # Reset and re-run all migrations
-```
-
-## Project Structure
-
-```
-src/
-├── main.jsx              # React entry point
-├── routes/
-│   ├── App.jsx           # Client routes
-│   └── api/              # API routes (auto-loaded)
-├── controllers/          # Business logic
-├── models/               # Database queries
-├── middleware/           # Route middleware
-├── helpers/              # Utility functions
-└── client/
-    ├── layouts/          # Layout components
-    ├── pages/            # Page components
-    └── components/       # Reusable UI
-```
-
-## Scaffolding
-
-```bash
-npx basicben make:controller User
-npx basicben make:model User
-npx basicben make:route users
-npx basicben make:migration create_users
-```
-
-## Configuration
-
-Edit `basicben.config.js` to customize server settings, CORS, database, and more.
-
-## Documentation
-
-Full documentation: [github.com/BasicBenFramework/basicben-framework](https://github.com/BasicBenFramework/basicben-framework)

package/my-test-app/basicben.config.js

@@ -1,33 +0,0 @@
-/**
- * BasicBen Configuration
- *
- * See documentation for all available options.
- */
-
-export default {
-  // Server options
-  port: 3001,
-
-  // CORS configuration
-  cors: {
-    origin: '*',
-    methods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'],
-    credentials: true
-  },
-
-  // Body parser options
-  bodyParser: {
-    limit: '1mb'
-  },
-
-  // Static file serving
-  static: {
-    dir: 'public'
-  },
-
-  // Database configuration
-  // db: {
-  //   driver: 'sqlite',
-  //   url: process.env.DATABASE_URL || './data.db'
-  // }
-}

package/my-test-app/index.html

@@ -1,54 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>BasicBen App</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <script>
-      tailwind.config = {
-        darkMode: 'class',
-        theme: {
-          extend: {
-            colors: {
-              dark: {
-                900: '#0f0f0f',
-                800: '#1a1a1a',
-                700: '#222222',
-                600: '#333333'
-              }
-            },
-            animation: {
-              'slide-in': 'slideIn 0.3s ease-out',
-              'slide-out': 'slideOut 0.2s ease-in',
-              'fade-in': 'fadeIn 0.2s ease-out',
-              'fade-out': 'fadeOut 0.15s ease-in',
-            },
-            keyframes: {
-              slideIn: {
-                '0%': { transform: 'translateX(100%)', opacity: '0' },
-                '100%': { transform: 'translateX(0)', opacity: '1' }
-              },
-              slideOut: {
-                '0%': { transform: 'translateX(0)', opacity: '1' },
-                '100%': { transform: 'translateX(100%)', opacity: '0' }
-              },
-              fadeIn: {
-                '0%': { opacity: '0' },
-                '100%': { opacity: '1' }
-              },
-              fadeOut: {
-                '0%': { opacity: '1' },
-                '100%': { opacity: '0' }
-              }
-            }
-          }
-        }
-      }
-    </script>
-  </head>
-  <body class="bg-dark-900 text-white">
-    <div id="root"></div>
-    <script type="module" src="/src/main.jsx"></script>
-  </body>
-</html>

package/my-test-app/migrations/001_create_users.js

@@ -1,15 +0,0 @@
-export const up = async (db) => {
-  await db.exec(`
-    CREATE TABLE users (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      name TEXT NOT NULL,
-      email TEXT UNIQUE NOT NULL,
-      password TEXT NOT NULL,
-      created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-    )
-  `)
-}
-
-export const down = async (db) => {
-  await db.exec('DROP TABLE IF EXISTS users')
-}

package/my-test-app/migrations/002_create_posts.js

@@ -1,18 +0,0 @@
-export const up = async (db) => {
-  await db.exec(`
-    CREATE TABLE posts (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      user_id INTEGER NOT NULL,
-      title TEXT NOT NULL,
-      content TEXT NOT NULL,
-      published BOOLEAN DEFAULT 0,
-      created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-      FOREIGN KEY (user_id) REFERENCES users(id)
-    )
-  `)
-}
-
-export const down = async (db) => {
-  await db.exec('DROP TABLE IF EXISTS posts')
-}