Registry / devops / hamroun-framework-create

hamroun-framework-create

library1.0.125jsnpmunverified

hamroun-framework-create is a modern full-stack JavaScript framework (v1.0.125) that offers file-based routing, automatic API generation, and built-in CLI tools for scaffolding components, pages, and layouts. It uses Solid.js and TailwindCSS out of the box, with Hot Module Replacement during development. Key differentiators include its opinionated project structure and automatic route handling, making it a turnkey solution for building full-stack applications. Released under MIT license with active updates.

devops

npm install hamroun-framework-create

package ↗

INSTALL

IMPORT

SIG · HAMROUN-FRAMEWORK-

hamroun-framework-create

devopsjavascriptv1.0.125

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createApp

✓ import { createApp } from 'hamroun-framework-create'

Main framework export for initializing an app. ESM only.

definePage

✓ import { definePage } from 'hamroun-framework-create'

Used to define a page component in file-based routing.

defineApiRoute

✓ import { defineApiRoute } from 'hamroun-framework-create'

Used to define an API route handler.

Creates a new project with a home page and an API route returning JSON.

// Create a new project // npx hamroun-framework-create create my-app // cd my-app // MyApp/src/app/home/page.jsx import { definePage } from 'hamroun-framework-create'; export default definePage(() => { return <div>Home Page</div>; }); // MyApp/src/api/hello.js import { defineApiRoute } from 'hamroun-framework-create'; export default defineApiRoute((req, res) => { res.json({ message: 'Hello World' }); });

Debug

Known issues

deprecatedThe `hamroun-framework-create` package has been renamed to `@hamroun/framework` in later versions. This package is deprecated.

fix

Use `@hamroun/framework` instead.

affects: >=1.0.0 <2.0.0

gotchaFile-based routing requires specific file naming convention: `page.jsx` for pages and `layout.jsx` for layouts. Wrong filenames are ignored.

fix

Ensure files are named exactly `page.jsx` or `layout.jsx` in the appropriate directories.

affects: >=1.0.0

gotchaThe project structure is rigid; moving `dep/front/` folder breaks the build.

fix

Do not rename or relocate the `dep/front` directory; it is required by the framework.

affects: >=1.0.0

deprecatedThe `npm run g component` shorthand may be removed in a future version.

fix

Use `npm run generate component` instead.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'hamroun-framework-create'

The package is not installed or globally available.

fix

Run `npm install hamroun-framework-create` in your project directory.

Command 'create' not found

The CLI was run without installing the package (npx may fail if npm registry is not properly configured).

fix

Ensure you are using Node.js v14+ and run `npx hamroun-framework-create create my-app` from a clean directory.

TypeError: definePage is not a function

Using CommonJS require instead of ESM import.

fix

Replace `const { definePage } = require('hamroun-framework-create')` with `import { definePage } from 'hamroun-framework-create'`.

Upgrade

Version history

1.0.125latest on npm

Audit

Dependencies

solid-jsrequiredUI library for building user interfaces

tailwindcssrequiredUtility-first CSS framework for styling

Agent activity

6 hits · last 30 days

node

Resources

packagehamroun-framework-create ↗