create-absolutejs 0.8.2 → 0.9.0

package/LICENSE

@@ -1,24 +1,24 @@
-```
-# Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
-
-By using this project, you agree to the following terms under the Creative Commons Attribution-NonCommercial 4.0 International License.
-
-## License Summary
-This license allows you to:
-- **Share**: Copy and redistribute the material in any medium or format.
-- **Adapt**: Remix, transform, and build upon the material.
-
-**Under the following conditions**:
-- **Attribution**: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
-- **Non-Commercial**: You may not use the material for commercial purposes.
-
-## Full License Text
-The full license text can be found at: https://creativecommons.org/licenses/by-nc/4.0/legalcode
-
-## Contact Information for Commercial Use
-For commercial use, licensing inquiries, or additional permissions, please contact:
-Alex Kahn
-alexkahndev@gmail.com
-alexkahndev.github.io
-```
-
+```
+# Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+
+By using this project, you agree to the following terms under the Creative Commons Attribution-NonCommercial 4.0 International License.
+
+## License Summary
+This license allows you to:
+- **Share**: Copy and redistribute the material in any medium or format.
+- **Adapt**: Remix, transform, and build upon the material.
+
+**Under the following conditions**:
+- **Attribution**: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+- **Non-Commercial**: You may not use the material for commercial purposes.
+
+## Full License Text
+The full license text can be found at: https://creativecommons.org/licenses/by-nc/4.0/legalcode
+
+## Contact Information for Commercial Use
+For commercial use, licensing inquiries, or additional permissions, please contact:
+Alex Kahn
+alexkahndev@gmail.com
+alexkahndev.github.io
+```
+

package/README.md

@@ -1,179 +1,179 @@
-# create-absolutejs
-
-A CLI tool to scaffold new AbsoluteJS projects quickly and effortlessly.
-
-## Usage
-
-Scaffold a new project called `<project-name>`:
-
-```bash
-bun create absolutejs my-app
-```
-
-Alternatively, using npm, Yarn, or pnpm:
-
-```bash
-npm create absolutejs my-app
-yarn create absolutejs my-app
-pnpm create absolutejs my-app
-```
-
-By default, the CLI will interactively prompt you for any missing configuration values. You can also supply flags to skip those prompts:
-
-- To skip **all** optional prompts and use `none` for every optional configuration:
-    ```bash
-    bun create absolutejs my-app --skip
-    ```
-- To skip **one** optional prompt without providing a real value, pass `none` to that flag:
-    ```bash
-    bun create absolutejs my-app --auth none --engine none
-    ```
-
-## Options
-
-```text
-Usage: create-absolute [project-name] [options]
-```
-
-### Arguments
-
-- `project-name`  
-  Name of the application to create. If omitted, you'll be prompted to enter one.
-
-### Options
-
-- `--help`, `-h`  
-  Show this help message and exit.
-
-- `--debug`, `-d`  
-  Display a summary of the project configuration after creation.
-
-- `--angular`  
-  Include an Angular frontend.
-
-- `--angular-dir <directory>`  
-  Specify the directory for and use the Angular frontend.
-
-- `--assets <directory>`  
-  Directory name for your static assets.
-
-- `--auth <plugin|none>`  
-  Pre-configured auth plugin (currently only `absolute-auth`) or `none`.
-
-- `--biome`  
-  Use Biome for code quality and formatting.
-
-- `--build <direrctory>`  
-  Output directory for build artifacts.
-
-- `--db <engine|none>`  
-  Database engine (`postgresql` | `mysql` | `sqlite` | `mongodb` | `redis` | `singlestore` | `cockroachdb` | `mssql`) or `none`.
-
-- `--db-dir <directory>`  
-  Directory name for your database files.
-
-- `--db-host <provider|none>`  
-  Database host provider (`neon` | `planetscale` | `supabase` | `turso` | `vercel` | `upstash` | `atlas`) or `none`.
-
-- `--directory <default|custom>`  
-  Directory-naming strategy: `default` or `custom`.
-
-- `--eslint+prettier`  
-  Use ESLint + Prettier for code quality and formatting.
-
-- `--git`  
-  Initialize a Git repository.
-
-- `--html`  
-  Include a plain HTML frontend.
-
-- `--html-dir <directory>`  
-  Specify the directory for and use the HTML frontend.
-
-- `--html-scripts`  
-  Enable HTML scripting with TypeScript.
-
-- `--htmx`  
-  Include an HTMX frontend.
-
-- `--htmx-dir <directory>`  
-  Specify the directory for and use the HTMX frontend.
-
-- `--install`  
-  Use the same package manager to install dependencies.
-
-- `--lts`  
-  Use LTS versions of required packages.
-
-- `--orm <drizzle|prisma|none>`  
-  ORM to configure: `drizzle` | `prisma` | `none`.
-
-- `--plugin <plugin>`  
-  Elysia plugin(s) to include (repeatable); `none` skips plugin setup.
-
-- `--react`  
-  Include a React frontend.
-
-- `--react-dir <directory>`  
-  Specify the directory for and use the React frontend.
-
-- `--skip`  
-  Skip non-required prompts; uses `none` for all optional configs.
-
-- `--svelte`  
-  Include a Svelte frontend.
-
-- `--svelte-dir <directory>`  
-  Specify the directory for and use the Svelte frontend.
-
-- `--tailwind`  
-  Include Tailwind CSS setup.
-
-- `--tailwind-input <file>`  
-  Path to your Tailwind CSS entry file.
-
-- `--tailwind-output <file>`  
-  Path for the generated Tailwind CSS bundle.
-
-- `--vue`  
-  Include a Vue frontend.
-
-- `--vue-dir <directory>`  
-  Specify the directory for and use the Vue frontend.
-
-## Directory Configuration
-
-Choose between the **default** layout (pre-configured folder names) or **custom**, which prompts you to specify each directory name yourself:
-
-```bash
-bun create absolutejs my-app --directory custom
-```
-
-## Debug & LTS Flags
-
-- `--debug`, `-d`  
-  After scaffolding, prints a detailed summary of your configuration (language, frontends, directories, etc.).
-- `--lts`  
-  Instructs the CLI to fetch and pin the latest published versions of your dependencies instead of its default pinned versions.
-
-## Getting Started
-
-Once the scaffold completes, you’re ready to go:
-
-```bash
-cd my-app
-# (If you skipped automated install)
-bun install
-# Then start the dev server
-bun run dev
-```
-
-If you downloaded this repository to test or make changes you can use `bun run test` to start the created dev server without having to change directories back and forth.
-
-## Contributing
-
-Contributions are welcome! Feel free to open issues or submit pull requests to improve the CLI.
-
-## License
-
-Licensed under CC BY-NC 4.0.
+# create-absolutejs
+
+A CLI tool to scaffold new AbsoluteJS projects quickly and effortlessly.
+
+## Usage
+
+Scaffold a new project called `<project-name>`:
+
+```bash
+bun create absolutejs my-app
+```
+
+Alternatively, using npm, Yarn, or pnpm:
+
+```bash
+npm create absolutejs my-app
+yarn create absolutejs my-app
+pnpm create absolutejs my-app
+```
+
+By default, the CLI will interactively prompt you for any missing configuration values. You can also supply flags to skip those prompts:
+
+- To skip **all** optional prompts and use `none` for every optional configuration:
+    ```bash
+    bun create absolutejs my-app --skip
+    ```
+- To skip **one** optional prompt without providing a real value, pass `none` to that flag:
+    ```bash
+    bun create absolutejs my-app --auth none --engine none
+    ```
+
+## Options
+
+```text
+Usage: create-absolute [project-name] [options]
+```
+
+### Arguments
+
+- `project-name`  
+  Name of the application to create. If omitted, you'll be prompted to enter one.
+
+### Options
+
+- `--help`, `-h`  
+  Show this help message and exit.
+
+- `--debug`, `-d`  
+  Display a summary of the project configuration after creation.
+
+- `--angular`  
+  Include an Angular frontend.
+
+- `--angular-dir <directory>`  
+  Specify the directory for and use the Angular frontend.
+
+- `--assets <directory>`  
+  Directory name for your static assets.
+
+- `--auth <plugin|none>`  
+  Pre-configured auth plugin (currently only `absolute-auth`) or `none`.
+
+- `--biome`  
+  Use Biome for code quality and formatting.
+
+- `--build <direrctory>`  
+  Output directory for build artifacts.
+
+- `--db <engine|none>`  
+  Database engine (`postgresql` | `mysql` | `sqlite` | `mongodb` | `redis` | `singlestore` | `cockroachdb` | `mssql`) or `none`.
+
+- `--db-dir <directory>`  
+  Directory name for your database files.
+
+- `--db-host <provider|none>`  
+  Database host provider (`neon` | `planetscale` | `supabase` | `turso` | `vercel` | `upstash` | `atlas`) or `none`.
+
+- `--directory <default|custom>`  
+  Directory-naming strategy: `default` or `custom`.
+
+- `--eslint+prettier`  
+  Use ESLint + Prettier for code quality and formatting.
+
+- `--git`  
+  Initialize a Git repository.
+
+- `--html`  
+  Include a plain HTML frontend.
+
+- `--html-dir <directory>`  
+  Specify the directory for and use the HTML frontend.
+
+- `--html-scripts`  
+  Enable HTML scripting with TypeScript.
+
+- `--htmx`  
+  Include an HTMX frontend.
+
+- `--htmx-dir <directory>`  
+  Specify the directory for and use the HTMX frontend.
+
+- `--install`  
+  Use the same package manager to install dependencies.
+
+- `--lts`  
+  Use LTS versions of required packages.
+
+- `--orm <drizzle|prisma|none>`  
+  ORM to configure: `drizzle` | `prisma` | `none`.
+
+- `--plugin <plugin>`  
+  Elysia plugin(s) to include (repeatable); `none` skips plugin setup.
+
+- `--react`  
+  Include a React frontend.
+
+- `--react-dir <directory>`  
+  Specify the directory for and use the React frontend.
+
+- `--skip`  
+  Skip non-required prompts; uses `none` for all optional configs.
+
+- `--svelte`  
+  Include a Svelte frontend.
+
+- `--svelte-dir <directory>`  
+  Specify the directory for and use the Svelte frontend.
+
+- `--tailwind`  
+  Include Tailwind CSS setup.
+
+- `--tailwind-input <file>`  
+  Path to your Tailwind CSS entry file.
+
+- `--tailwind-output <file>`  
+  Path for the generated Tailwind CSS bundle.
+
+- `--vue`  
+  Include a Vue frontend.
+
+- `--vue-dir <directory>`  
+  Specify the directory for and use the Vue frontend.
+
+## Directory Configuration
+
+Choose between the **default** layout (pre-configured folder names) or **custom**, which prompts you to specify each directory name yourself:
+
+```bash
+bun create absolutejs my-app --directory custom
+```
+
+## Debug & LTS Flags
+
+- `--debug`, `-d`  
+  After scaffolding, prints a detailed summary of your configuration (language, frontends, directories, etc.).
+- `--lts`  
+  Instructs the CLI to fetch and pin the latest published versions of your dependencies instead of its default pinned versions.
+
+## Getting Started
+
+Once the scaffold completes, you’re ready to go:
+
+```bash
+cd my-app
+# (If you skipped automated install)
+bun install
+# Then start the dev server
+bun run dev
+```
+
+If you downloaded this repository to test or make changes you can use `bun run test` to start the created dev server without having to change directories back and forth.
+
+## Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests to improve the CLI.
+
+## License
+
+Licensed under CC BY-NC 4.0.

package/dist/data.js

@@ -167,8 +167,11 @@ export const defaultDependencies = [
 export const defaultPlugins = [
     {
         imports: [
+            { isPlugin: false, packageName: 'BuildConfig' },
             { isPlugin: false, packageName: 'asset' },
             { isPlugin: false, packageName: 'build' },
+            { isPlugin: false, packageName: 'devBuild' },
+            { isPlugin: false, packageName: 'hmr' },
             { isPlugin: true, packageName: 'networking' }
         ],
         latestVersion: versions['@absolutejs/absolute'],

package/dist/generators/configurations/generateDrizzleConfig.js

@@ -1,21 +1,21 @@
 import { writeFileSync } from 'fs';
 import { join } from 'path';
 export const createDrizzleConfig = ({ projectName, databaseDirectory, databaseEngine }) => {
-    const drizzleConfig = `import { defineConfig } from "drizzle-kit";
-	import { env } from 'process';
-
-    if (!env.DATABASE_URL) {
-	throw new Error('DATABASE_URL must be set in the environment variables');
-}
-
-	export default defineConfig({
-		dbCredentials: {
-			url: env.DATABASE_URL
-		},
-		dialect: '${databaseEngine}',
-		out: '${databaseDirectory}/migrations',
-		schema: '${databaseDirectory}/schema.ts'
-	});
+    const drizzleConfig = `import { defineConfig } from "drizzle-kit";
+	import { env } from 'process';
+
+    if (!env.DATABASE_URL) {
+	throw new Error('DATABASE_URL must be set in the environment variables');
+}
+
+	export default defineConfig({
+		dbCredentials: {
+			url: env.DATABASE_URL
+		},
+		dialect: '${databaseEngine}',
+		out: '${databaseDirectory}/migrations',
+		schema: '${databaseDirectory}/schema.ts'
+	});
 `;
     writeFileSync(join(projectName, 'drizzle.config.ts'), drizzleConfig);
 };

package/dist/generators/configurations/generatePrettierrc.js

@@ -1,13 +1,13 @@
 export const generatePrettierrc = (frontends) => {
     const usesSvelte = frontends.some((frontend) => frontend === 'svelte');
-    return `{
-		"endOfLine": "auto",
-		"printWidth": 80,
-		"semi": true,
-		"singleQuote": true,
-		"tabWidth": 4,
-		"trailingComma": "none",
-		"useTabs": true
-		${usesSvelte ? `,"plugins": ["prettier-plugin-svelte"],\n"overrides": [{"files": "*.svelte", "options": {"parser": "svelte"}}]` : ''}
+    return `{
+		"endOfLine": "auto",
+		"printWidth": 80,
+		"semi": true,
+		"singleQuote": true,
+		"tabWidth": 4,
+		"trailingComma": "none",
+		"useTabs": true
+		${usesSvelte ? `,"plugins": ["prettier-plugin-svelte"],\n"overrides": [{"files": "*.svelte", "options": {"parser": "svelte"}}]` : ''}
 	}`;
 };

package/dist/generators/configurations/initializeRoot.js

@@ -14,8 +14,10 @@ export const initalizeRoot = (projectName, templatesDirectory) => {
     copyFileSync(constantsSrc, constantsDest);
     const frontendDirectory = join(srcDir, 'frontend');
     const backendDirectory = join(srcDir, 'backend');
+    const publicDirectory = join(projectName, 'public');
     mkdirSync(frontendDirectory);
     mkdirSync(backendDirectory);
+    mkdirSync(publicDirectory);
     const projectAssetsDirectory = join(backendDirectory, 'assets');
     mkdirSync(projectAssetsDirectory);
     mkdirSync(join(projectAssetsDirectory, 'ico'), { recursive: true });

package/dist/generators/db/dockerInitTemplates.js

@@ -1,95 +1,95 @@
-const postgresqlUsers = `CREATE TABLE IF NOT EXISTS users (
-  auth_sub   VARCHAR(255) PRIMARY KEY,
-  created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-  metadata   JSONB        DEFAULT '{}'::jsonb
+const postgresqlUsers = `CREATE TABLE IF NOT EXISTS users (
+  auth_sub   VARCHAR(255) PRIMARY KEY,
+  created_at TIMESTAMP NOT NULL DEFAULT NOW(),
+  metadata   JSONB        DEFAULT '{}'::jsonb
 );`;
-const postgresqlCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
-  uid         INTEGER   PRIMARY KEY GENERATED ALWAYS AS IDENTITY,
-  count       INTEGER   NOT NULL,
-  created_at  TIMESTAMP NOT NULL DEFAULT NOW()
+const postgresqlCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
+  uid         INTEGER   PRIMARY KEY GENERATED ALWAYS AS IDENTITY,
+  count       INTEGER   NOT NULL,
+  created_at  TIMESTAMP NOT NULL DEFAULT NOW()
 );`;
-const mysqlUsers = `CREATE TABLE IF NOT EXISTS users (
-  auth_sub   VARCHAR(255) PRIMARY KEY,
-  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  metadata   JSON         DEFAULT (JSON_OBJECT())
+const mysqlUsers = `CREATE TABLE IF NOT EXISTS users (
+  auth_sub   VARCHAR(255) PRIMARY KEY,
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata   JSON         DEFAULT (JSON_OBJECT())
 );`;
-const mysqlCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
-  uid         INT AUTO_INCREMENT PRIMARY KEY,
-  count       INT NOT NULL,
-  created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+const mysqlCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
+  uid         INT AUTO_INCREMENT PRIMARY KEY,
+  count       INT NOT NULL,
+  created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
 );`;
-const mariadbUsers = `CREATE TABLE IF NOT EXISTS users (
-  auth_sub   VARCHAR(255) PRIMARY KEY,
-  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  metadata   JSON         DEFAULT ('{}')
+const mariadbUsers = `CREATE TABLE IF NOT EXISTS users (
+  auth_sub   VARCHAR(255) PRIMARY KEY,
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata   JSON         DEFAULT ('{}')
 );`;
-const mariadbCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
-  uid         INT AUTO_INCREMENT PRIMARY KEY,
-  count       INT NOT NULL,
-  created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+const mariadbCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
+  uid         INT AUTO_INCREMENT PRIMARY KEY,
+  count       INT NOT NULL,
+  created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
 );`;
-const singlestoreUsers = `CREATE TABLE IF NOT EXISTS users (
-  auth_sub   VARCHAR(255) PRIMARY KEY,
-  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-  metadata   JSON         DEFAULT ('{}')
+const singlestoreUsers = `CREATE TABLE IF NOT EXISTS users (
+  auth_sub   VARCHAR(255) PRIMARY KEY,
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata   JSON         DEFAULT ('{}')
 );`;
-const singlestoreCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
-  uid         INT AUTO_INCREMENT PRIMARY KEY,
-  count       INT NOT NULL,
-  created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+const singlestoreCountHistory = `CREATE TABLE IF NOT EXISTS count_history (
+  uid         INT AUTO_INCREMENT PRIMARY KEY,
+  count       INT NOT NULL,
+  created_at  TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
 );`;
-const cockroachdbUsers = `CREATE TABLE IF NOT EXISTS users (
-  auth_sub   VARCHAR(255) PRIMARY KEY,
-  created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-  metadata   JSONB        DEFAULT '{}'::jsonb
+const cockroachdbUsers = `CREATE TABLE IF NOT EXISTS users (
+  auth_sub   VARCHAR(255) PRIMARY KEY,
+  created_at TIMESTAMP NOT NULL DEFAULT NOW(),
+  metadata   JSONB        DEFAULT '{}'::jsonb
 );`;
-const cockroachdbCountHistory = `CREATE SEQUENCE IF NOT EXISTS count_history_uid_seq START WITH 1 INCREMENT BY 1;
-CREATE TABLE IF NOT EXISTS count_history (
-  uid         BIGINT PRIMARY KEY DEFAULT nextval('count_history_uid_seq'),
-  count       INT      NOT NULL,
-  created_at  TIMESTAMP NOT NULL DEFAULT NOW()
+const cockroachdbCountHistory = `CREATE SEQUENCE IF NOT EXISTS count_history_uid_seq START WITH 1 INCREMENT BY 1;
+CREATE TABLE IF NOT EXISTS count_history (
+  uid         BIGINT PRIMARY KEY DEFAULT nextval('count_history_uid_seq'),
+  count       INT      NOT NULL,
+  created_at  TIMESTAMP NOT NULL DEFAULT NOW()
 );`;
-const mssqlUsers = `IF OBJECT_ID('users','U') IS NULL
-BEGIN
-  CREATE TABLE users (
-    auth_sub   NVARCHAR(255) PRIMARY KEY,
-    created_at DATETIME2     NOT NULL DEFAULT SYSUTCDATETIME(),
-    metadata   NVARCHAR(MAX) NULL
-  );
+const mssqlUsers = `IF OBJECT_ID('users','U') IS NULL
+BEGIN
+  CREATE TABLE users (
+    auth_sub   NVARCHAR(255) PRIMARY KEY,
+    created_at DATETIME2     NOT NULL DEFAULT SYSUTCDATETIME(),
+    metadata   NVARCHAR(MAX) NULL
+  );
 END;`;
-const mssqlCountHistory = `IF OBJECT_ID('count_history','U') IS NULL
-BEGIN
-  CREATE TABLE count_history (
-    uid         INT IDENTITY(1,1) PRIMARY KEY,
-    count       INT        NOT NULL,
-    created_at  DATETIME2   NOT NULL DEFAULT SYSUTCDATETIME()
-  );
+const mssqlCountHistory = `IF OBJECT_ID('count_history','U') IS NULL
+BEGIN
+  CREATE TABLE count_history (
+    uid         INT IDENTITY(1,1) PRIMARY KEY,
+    count       INT        NOT NULL,
+    created_at  DATETIME2   NOT NULL DEFAULT SYSUTCDATETIME()
+  );
 END;`;
-const gelUsers = `create type users {
-  create required property auth_sub: str {
-    create constraint exclusive;
-  };
-
-  create required property created_at: datetime {
-    set default := datetime_current();
-  };
-
-  create required property metadata: json {
-    set default := to_json('{}');
-  };
+const gelUsers = `create type users {
+  create required property auth_sub: str {
+    create constraint exclusive;
+  };
+
+  create required property created_at: datetime {
+    set default := datetime_current();
+  };
+
+  create required property metadata: json {
+    set default := to_json('{}');
+  };
 };`;
-const gelCountHistory = `create scalar type CountHistoryUid extending sequence;
-create type count_history {
-  create required property uid: CountHistoryUid {
-    create constraint exclusive;
-    set default := sequence_next(introspect CountHistoryUid);
-  };
-
-  create required property count: int16;
-
-  create required property created_at: datetime {
-    set default := datetime_current();
-  };
+const gelCountHistory = `create scalar type CountHistoryUid extending sequence;
+create type count_history {
+  create required property uid: CountHistoryUid {
+    create constraint exclusive;
+    set default := sequence_next(introspect CountHistoryUid);
+  };
+
+  create required property count: int16;
+
+  create required property created_at: datetime {
+    set default := datetime_current();
+  };
 };`;
 export const userTables = {
     cockroachdb: cockroachdbUsers,