This is a submission for the Neon Open Source Starter Kit Challenge: Ultimate Starter Kit
My Kit
For the Neon OSS Challenge, I've built a Node.js CLI for shipping Next.js SaaS applications much faster than ever. The primary idea was to build something unique which can handle multiple starter templates at once. Hence, for now the starter kit comes in two flavors:
- A Next.js project with Drizzle ORM
- A Next.js project with Prisma :)
Why Neon OSS Starter Kit?
It is a common practice to start a new project by copying and pasting code from a previous project. This is not only time-consuming but also error-prone. The Neon OSS Starter Kit provides a well-documented, easy-to-use, and simple starting point for building your SaaS projects with Neon.
The starter kit is not just about setting up a simple database connected to the frontend; you can even use the power of machine learning with Neon as a Vector database, Axios for making server side calls. Learn more about these advanced features from the Neon OSS Kit docs page.
Tools and Features:
The starter kit comes with a bunch of pre-configured setups that allow you to start building your project without any additional configuration. Some of the major features include:
- Neon (Database)
- Clerk (Authentication)
- Prisma/Drizzle (ORM tools)
- Axios (A promise-based HTTP Client for node.js and the browser)
- A simple and customizable frontend powered by React.js, Next.js, ShadcnUI, and TailwindCSS.
To scaffold the Neon OSS Starter Kit, you can run the following command:
npx @rohittcodes/neon-osskit@latest
Note: This command will create a new Next.js project with Prisma ORM by default. You can explicitly provide other configurations (Drizzle/Prisma for now) by including drizzle or prisma at the end of the command.
npx @rohittcodes/neon-osskit@latest drizzle
Preview
Link to Kit
As mentioned above, the starter kit is divided into 3 individual repositories for now, and is documented with a docs repo which is the main source for any query related stuff.
- Then comes the Node.js CLI repository for the starter kit, which is powered by 2 individual templates:
Further moving on, the focus will be to turn these repos into a monorepo and maintain all the templates at a single source. And again, You can find the documentation here: https://osskit-neon.vercel.app
RohittCodes / neon-osskit
dev.to Neon-oss challenge winner. Neon OSS Kit is a collection of tools and services that help you build and scale your applications with Neon.
Neon OSS Starter Kit Documentation
Welcome to the official documentation for the Neon OSS Starter Kit. This documentation will guide you through the installation, setup, and usage of the Neon OSS Starter Kit.
Creating a new project using the Neon OSS Starter Kit
To create a new project using the Neon OSS Starter Kit, you can use the following command:
npx @rohittcodes/neon-osskit@latest
Note: This command will create a new next project with Prisma ORM by default.
To create a new project with drizzle, you can use the following command:
npx @rohittcodes/neon-osskit@latest drizzle
for prisma again
npx @rohittcodes/neon-osskit@latest prisma
Further Steps
After creating a new project using the Neon OSS Starter Kit, you can follow the steps below to get started:
- Add your environment variables to the
.env
file
DATABASE_URL="your-neon-database-url"
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your-clerk-publishable-key
CLERK_SECRET_KEY=your-clerk-secret-key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
-
Delete the
.git
folder and rungit init
to initialize a new git repository forโฆ
Your Journey
Developing applications and tools meant for better utilization is what drives me, and developing this Node.js CLI was the first of its kind. I've been working on full-stack projects for the past year, but this challenge gave me the opportunity to build something I've dreamt of since my early days. Although the project isn't fully complete yet, I'll push myself to add more features to it and make it a monorepo as soon as possible.
The journey was quite hectic, but now that it's done, I'll be chilling for a little time. Why not contribute to some cool open-source projects after a little break? The official documentation provided a lot of help, which made the game easier. However, the idea wasn't just to build a CLI for only 2 templates, but I started it a little late.
Nevertheless, the journey was great, and I learned a lot from it.
Contributors
If you're an open source contributor, and would like to contribute to the documentation, please feel free to drop by and raise some issues + PRs. Thanks in advance๐.
Top comments (0)