our-favorite-tech-stack.mdx 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238
  1. ---
  2. title: "Our Favorite Tech Stack"
  3. description: "A curated list of our recommended technologies and tools for building modern web applications with Cline."
  4. ---
  5. ## Recommended Stack for New Cline Users (2025)
  6. ### Your Complete Development Environment
  7. #### Development Tools
  8. - **VS Code** - Your code editor, [download here](https://code.visualstudio.com/)
  9. - **GitHub** - Where your code lives, [sign up here](https://github.com)
  10. #### Frontend
  11. - **Next.js 14+** - React framework with App Router
  12. - **Tailwind CSS** - Beautiful styling without writing CSS
  13. - **TypeScript** - JavaScript, but safer and smarter
  14. #### Backend
  15. - **Supabase** - Your complete backend solution, [sign up with GitHub](https://supabase.com)
  16. - PostgreSQL database
  17. - Authentication
  18. - File storage
  19. - Real-time updates
  20. #### Deployment
  21. - **Vercel** - Where your app runs, [sign up with GitHub](https://vercel.com)
  22. - Automatic deployments from GitHub
  23. - Preview deployments for testing
  24. - Production-ready CDN
  25. #### AI Development
  26. Choose your AI assistant based on your needs:
  27. | Model | Input Cost (per 1M tokens) | Output Cost (per 1M tokens) | Best For |
  28. | ----------------- | -------------------------- | --------------------------- | ------------------------------ |
  29. | Claude 3.5 Sonnet | $3.00 | $15.00 | Production apps, complex tasks |
  30. | DeepSeek R1 | $1.00 | $3.00 | Budget-conscious production |
  31. | DeepSeek V3 | $0.14 | $2.20 | Budget-conscious development |
  32. #### Free Tier Benefits
  33. **Vercel (Hobby)**
  34. - 100 GB data transfer/month
  35. - 100k serverless function invocations
  36. - 100 MB deployment size
  37. - Automatic HTTPS & CI/CD
  38. **Supabase (Free)**
  39. - 500 MB database storage
  40. - 1 GB file storage
  41. - 50k monthly active users
  42. - 2M real-time messages/month
  43. **GitHub (Free)**
  44. - Unlimited public repositories
  45. - GitHub Actions CI/CD
  46. - Project management tools
  47. - Collaboration features
  48. ### Getting Started
  49. 1. Install the development essentials:
  50. - Follow our [Development Essentials Installation Guide](https://docs.cline.bot/getting-started/installing-dev-essentials)
  51. 2. Set up Cline's Memory Bank:
  52. - Follow the [Memory Bank setup instructions](https://docs.cline.bot/prompting/cline-memory-bank)
  53. - Create an empty `cline_docs` folder in your project root
  54. - Create `projectBrief.md` in the `cline_docs` folder (see example below)
  55. - Tell Cline to "initialize memory bank"
  56. 3. Add our recommended stack configuration:
  57. - Create `.clinerules` file (see template below)
  58. - Let Cline handle the rest!
  59. #### Example Project Brief
  60. ```markdown
  61. # Project Brief
  62. ## Overview
  63. Building a [type of application] that will [main purpose].
  64. ## Core Features
  65. - Feature 1
  66. - Feature 2
  67. - Feature 3
  68. ## Target Users
  69. [Describe who will use your application]
  70. ## Technical Preferences (optional)
  71. - Any specific technologies you want to use
  72. - Any specific requirements or constraints
  73. ```
  74. ### .clinerules Template
  75. ```markdown
  76. # Project Configuration
  77. ## Tech Stack
  78. - Next.js 14+ with App Router
  79. - Tailwind CSS for styling
  80. - Supabase for backend
  81. - Vercel for deployment
  82. - GitHub for version control
  83. ## Project Structure
  84. /src
  85. /app # Next.js App Router pages
  86. /components # React components
  87. /lib # Utility functions
  88. /types # TypeScript types
  89. /supabase
  90. /migrations # SQL migration files
  91. /seed # Seed data files
  92. /public # Static assets
  93. ## Database Migrations
  94. SQL files in /supabase/migrations should:
  95. - Use sequential numbering: 001, 002, etc.
  96. - Include descriptive names
  97. - Be reviewed by Cline before execution
  98. Example: 001_create_users_table.sql
  99. ## Development Workflow
  100. - Cline helps write and review code changes
  101. - Vercel automatically deploys from main branch
  102. - Database migrations reviewed by Cline before execution
  103. ## Security
  104. DO NOT read or modify:
  105. - .env files
  106. - \*_/config/secrets._
  107. - Any file containing API keys or credentials
  108. ```
  109. ### Learning Resources (2025)
  110. Want to learn more about the technologies we're using? Here are some great resources:
  111. #### Next.js and React
  112. - [Official Learn Next.js Course](https://nextjs.org/learn) - Interactive tutorial
  113. - [NextJS App Router: Modern Web Dev in 1 Hour](https://www.youtube.com/nextjs-modern) - Quick overview
  114. - [Building Real-World Apps with Next.js](https://www.youtube.com/nextjs-real-world) - Practical examples
  115. #### Supabase
  116. - [Supabase From Scratch](https://www.udemy.com/supabase-scratch) - Comprehensive course
  117. - [Official Quickstart Guides](https://supabase.com/docs/guides/getting-started)
  118. - [Real-Time Apps with Next.js and Supabase](https://www.newline.co/courses/supabase-nextjs)
  119. #### Tailwind CSS
  120. - [Tailwind CSS Tutorial for Beginners](https://www.youtube.com/tailwind-2025)
  121. - [Official Tailwind Documentation](https://tailwindcss.com/docs)
  122. - Interactive course at [Scrimba Tailwind CSS Course](https://scrimba.com/learn/tailwind)
  123. ### Other Things to Know
  124. #### Working with Git & GitHub
  125. Git helps you track changes in your code and collaborate with others. Here are the essential commands you'll use:
  126. **Daily Development**
  127. ```bash
  128. # Save your changes (do this often!)
  129. git add . # Stage all changed files
  130. git commit -m "Add login page" # Save changes with a clear message
  131. # Share your changes
  132. git push origin main # Upload to GitHub
  133. ```
  134. **Common Workflow**
  135. 1. **Start of day**: Get latest changes
  136. ```bash
  137. git pull origin main # Download latest code
  138. ```
  139. 2. **During development**: Save work regularly
  140. ```bash
  141. git add .
  142. git commit -m "Clear message about changes"
  143. ```
  144. 3. **End of day**: Share your progress
  145. ```bash
  146. git push origin main # Upload to GitHub
  147. ```
  148. **Best Practices**
  149. - Commit often with clear messages
  150. - Pull before starting new work
  151. - Push completed work to share with others
  152. - Use `.gitignore` to avoid committing sensitive files
  153. > **Tip**: Vercel automatically deploys when you push to main!
  154. #### Environment Variables
  155. - Store secrets in `.env.local` for development
  156. - Add them to Vercel project settings for production
  157. - Never commit `.env` files to Git
  158. #### Getting Help
  159. 1. Use `/help` in Cline chat for immediate assistance
  160. 2. Check [Cline Documentation](https://docs.cline.bot)
  161. 3. Join our [Discord Community](https://discord.gg/cline)
  162. 4. Search GitHub issues for common problems
  163. Remember: Cline is here to help at every step. Just ask for guidance or clarification when needed!