chientrm.com – Personal Homepage & Web App

A modern, minimal, and instantly runnable personal homepage and web app.

🚀 Quick Start (End Users)

Run this web app instantly, no build or setup required:

1. Run instantly with npx

npx @microh-labs/home

2. Or install globally (optional)

npm install -g @microh-labs/home
ulabs_home

3. Or install locally in a project

npm install @microh-labs/home
npx ulabs_home

Custom port

To run on a specific port:

PORT=5000 npx @microh-labs/home
# or
PORT=5000 ulabs_home

The app will print the URL to access it in your browser.

🌟 Features

• Modern, minimal design using shadcn/ui React components
• Responsive and accessible
• Express API backend with Swagger docs

🛠️ For Developers

Tech Stack

• React + TypeScript
• Vite
• Tailwind CSS
• shadcn/ui
• Express (API)

Development (use pnpm)

Install dependencies:

pnpm install

Start the development server:

pnpm dev

Drizzle ORM migrations:

After changing your database schema, you can now run Drizzle migrations directly using the drizzle-kit CLI (thanks to drizzle.config.ts). No need to build and run the app first!

To push schema changes to your SQLite database:

pnpm drizzle-kit push:sqlite
# or
npx drizzle-kit push:sqlite

This will apply your schema changes and hydrate the database. You only need to run pnpm build and node . for production or to start the app normally.

Build for production:

pnpm build

For Maintainers: Publishing

This app is published to npm on every version tag push (e.g., 1.2.3).

To release a new version:

1. Bump the version in package.json (or just tag with the new version).
2. Create a git tag matching the new version:

   git tag 1.2.3
   git push --tags

3. GitHub Actions will build and publish to npm automatically.

Note: Lockfiles (pnpm-lock.yaml, etc.) are not published to npm.

© 2025 Chien Tran. All rights reserved.