https://github.com/chientrm/com
https://github.com/chientrm/com
blogs cloudflare d1 personal svelte sveltekit threejs tools wrangler
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/chientrm/com
- Owner: chientrm
- License: mit
- Created: 2025-09-21T06:33:20.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-09-21T08:47:30.000Z (8 months ago)
- Last Synced: 2025-09-21T10:25:56.133Z (8 months ago)
- Language: TypeScript
- Homepage:
- Size: 2.29 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```bash
npx @microh-labs/home
```
### 2. Or install globally (optional)
```bash
npm install -g @microh-labs/home
ulabs_home
```
### 3. Or install locally in a project
```bash
npm install @microh-labs/home
npx ulabs_home
```
#### Custom port
To run on a specific port:
```bash
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](https://ui.shadcn.com/) 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:
```bash
pnpm install
```
Start the development server:
```bash
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:
>
> ```bash
> 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:
```bash
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:
```bash
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.