MCPcopy Index your code
hub / github.com/boilerthing/boilerthing

github.com/boilerthing/boilerthing @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
114 symbols 427 edges 106 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Boilerthing

Does the world need another Next.js boilerplate? Absolutely! More offerings lead to higher standards and better products. Take a look around and give it a star if you find it valuable! This will make my day 🦄!

Demo

See it in action: https://boilerthing.vercel.app

TL;DR

Free and open-source Next.js 14 Boilerplate with (App Router), Next-auth (v5), Next-intl (translated routes), Prisma ORM, Resend, Tailwind CSS, and Shadcn/UI & Radix UI, plus many other features.

Features 🌟

  • 🚀 Next.js with App Router support
  • ⚙️ Centralized app config for easy modification
  • TypeScript for type checking
  • 🔑 Next-auth v5 for flexible authentication
  • 🌐 Next-intl for translations (i18n) and translated routes
  • 🗄️ Prisma ORM for database convenience
  • 🐳 Docker Compose for easy DB setup
  • 🎨 Tailwind CSS 3.4
  • 📱 Mobile-first Design approach
  • 🖼️ ShadCN/UI and Radix for awesome UI
  • 🎓 Typewriter Effect for landing page hero section
  • 🔐 T3 Env for type-safe environment variables
  • 📧 Resend for email sending
  • 📝 React Hook Form for form handling
  • 🚔 ReCaptcha for form security
  • 📋 Zod for validation
  • 🚨 ESLint for linting
  • 🖌️ Prettier for code formatting with import sorting
  • 🛡️ Sentry for error monitoring
  • 🗂️ Absolute imports with @ prefix

Development

  1. Run postgres locally:

bash docker run --name boilerthing -p 5432:5432 -d -e POSTGRES_PASSWORD=admin -e POSTGRES_USER=admin -e POSTGRES_DB=boilerthing postgres:latest

  1. Initialize prisma:

bash npx prisma generate npx prisma db push

  1. Populate .env based on .env.example

  2. Run the development server: bash npm run dev

Roadmap

Your support means a lot! Give this repo some stars, and I'll speed up the feature development.

Here are some features I'm planning to integrate into Boilerthing:

  • 🚧 Test setup with Jest
  • 📊 Analytics with Posthog
  • 💵 Payments with Stripe
  • 🚀 AWS Integration
  • 📈 Admin dashboard

Contributions

I'm open to any suggestions and improvements. Everyone is welcome to contribute to this project! Feel free to open an issue if you have questions or find a bug.

License

Licensed under the MIT License, Copyright © Egor Kirpichev 2024

See LICENSE for more information.

Extension points exported contracts — how you extend this code

IntlMessages (Interface)
(no doc)
global.d.ts
AppConfig (Interface)
(no doc)
app.config.ts
Result (Interface)
(no doc)
src/components/form-contact.tsx
LocalizedRoute (Interface)
(no doc)
src/lib/i18n.ts
SubmitMessageResponse (Interface)
(no doc)
src/components/form-contact.tsx
Session (Interface)
(no doc)
src/lib/auth/next-auth.d.ts
LocalizedContent (Interface)
(no doc)
src/components/landing-features.tsx
Feature (Interface)
(no doc)
src/components/landing-features.tsx

Core symbols most depended-on inside this repo

cn
called by 94
src/lib/utils.ts
useFormField
called by 4
src/components/ui/form.tsx
useCurrentPath
called by 4
src/hooks/use-current-path.tsx
useCurrentUser
called by 3
src/lib/auth/hooks/use-current-user.ts
getIsAdmin
called by 2
src/lib/auth/index.ts
useIsAdmin
called by 2
src/lib/auth/hooks/use-is-admin.ts
monthlySavings
called by 1
src/components/pricing-card.tsx
sendContactFormMessage
called by 1
src/lib/mail.ts

Shape

Function 98
Interface 13
Enum 3

Languages

TypeScript100%

Modules by API surface

src/components/form-contact.tsx5 symbols
src/lib/utils.ts4 symbols
src/lib/auth/index.ts4 symbols
src/components/ui/sheet.tsx3 symbols
src/components/pricing-card.tsx3 symbols
src/components/landing-features.tsx3 symbols
src/lib/i18n.ts2 symbols
src/lib/auth/db/user.ts2 symbols
src/components/ui/form.tsx2 symbols
src/components/ui/dialog.tsx2 symbols
src/components/ui/badge.tsx2 symbols
src/components/scroll-to-top.tsx2 symbols

For agents

$ claude mcp add boilerthing \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact