Bibbel

A personal bookmark management system you won't lose.

Tech Stack

A (non exhaustive) list of open-source frameworks and libraries used to build Bibbel:

• Tailwind CSS for CSS
• shadcn/ui with BaseUI for UI Components
• TanStack Start for building the fullstack React & Node.js web app
• Better-Auth for Auth & Authz
• Drizzle as on ORM
• Valibot a schema library for validating structural data (comparable to Zod)
• TUS for file uploads

Development

Run pnpm install and then pnpm run dev to run the app locally.

Enviroment

First you'll need to copy .env.template to .env and change it per instructions in the file

Run

Now you should be able to run pnpm dev to start the app locally.

Test

Run unit tests with pnpm run test

Scripts

• pnpm run dev: Start the Vite dev server on port 3000 with the Sentry preload.
• pnpm run build: Build the app and copy Sentry preload files into .output/server/.
• pnpm run preview: Preview the production build locally.
• pnpm run start: Run the built server output from .output/server/.
• pnpm run test: Run the Vitest suite.
• pnpm run lint: Fix ESLint issues.
• pnpm run format: Format the codebase with Prettier.
• pnpm run check: Validate formatting and lint rules.
• pnpm run db:drop: Drop the database via Drizzle Kit.
• pnpm run db:migrate: Apply database migrations.
• pnpm run db:generate: Generate database migrations from schema changes.

Git Hooks

Local git hooks are installed automatically on pnpm install and run:

• pnpm run check on pre-commit
• pnpm run test on pre-push

Hooks are skipped in CI. You can also bypass them with --no-verify or by setting SKIP_SIMPLE_GIT_HOOKS=1 or SKIP_INSTALL_SIMPLE_GIT_HOOKS=1 when installing.