Journl

Open source AI-driven journaling app that turns daily writing into structured reflection.

This is a monorepo powered by Turborepo and pnpm.

• Workspace layout is defined in pnpm-workspace.yaml.
• Shared task pipeline and env wiring live in turbo.json.

• Web app: apps/web, including marketing pages, authenticated journaling views, API routes, and editor UI.
• Shared packages: packages for auth, database access, usage domain logic, and BlockNote integration.
• Local dev utilities: apps/drizzle-studio and apps/stripe.
• Agents & Contributor guidance: AGENTS.md.

Use these paths as the fastest way to understand the product and core systems.

• App surfaces: apps/web/src/app
• Journal experience: apps/web/src/app/(app)/journal
• API routes: apps/web/src/app/api
• Editor integration: apps/web/src/components/editor
• AI/workflow logic: apps/web/src/ai and apps/web/src/workflows
• Auth and usage guards: apps/web/src/auth and apps/web/src/usage
• DB schema and usage domain: packages/db/src/schema.ts and packages/db/src/usage

Use the scripts in package.json as the canonical source for day-to-day commands.

• Install dependencies: pnpm install
• Start development tasks: pnpm dev
• Run quality gates: pnpm check and pnpm typecheck
• Build the workspace: pnpm build

Environment variables are loaded from a root .env file. See turbo.json for shared env names used by tasks.

For database workflows, use root scripts (pnpm db:push, pnpm db:studio) or the dedicated utility app in apps/drizzle-studio.

This project is licensed under the MIT License. See LICENSE.