How ixahmedxi/orbitkit works
Project Type & Purpose
• This is a Turborepo‐based monorepo scaffold (“OrbitKit”) that bundles:
• A marketing site (Astro)
• A documentation site (Mintlify/Astro)
• A web application (Next.js)
• A type‐safe tRPC API server
• Shared utility, UI, auth, db and config packages
• Purpose: Provide a fully opinionated, end‑to‑end starter for SaaS‐style products, including CI/CD, analytics, monitoring, authentication, ORM, file uploads, and theming.
File Structure Analysis
• Top‑level orchestration:
• turbo.json & root package.json drive Turborepo commands.
• Preconfigured Lint, Prettier, ESLint, Husky, Changesets, GitHub Actions for CI/CD.
• Apps/:
• apps/marketing – a public Astro site with Tailwind, PostHog instrumentation.
• apps/docs – documentation site powered by Mintlify/Astro.
• apps/web – Next.js app with tRPC routes, Uploadthing, Lucia Auth, PostHog, Sentry.
• Packages/ (shared code):
• packages/api – tRPC router definitions; entry point for API server.
• packages/auth – Lucia authentication integration (providers: GitHub, Google).
• packages/db – Drizzle ORM schemas & Neon DB config.
• packages/ui – Shadcn/Radix UI primitives & Storybook.
• packages/env – typed environment variables per app.
• packages/utils & packages/core – general utilities and core logic.
• packages/config/* – centralized ESLint, Tailwind, Vite, TSConfig, Storybook presets.
• packages/assets – font assets.
• CI/CD & Dev Tooling:
• .github/workflows – build, test, release, PR cleanup.
• scripts/ – workspace update helpers.
README Insights
• Tech stack: TypeScript, Astro, Next.js, tRPC, Drizzle ORM, Neon DB, Uploadthing, PostHog, Sentry, Lucia Auth, Tailwind CSS, Shadcn UI, Storybook, Turborepo.
• Emphasis on type‐safety, monorepo scale, ESM only.