Bleverse Relivator: Next.js Starter & Website Builder

Crafting the world's most powerful Next.js starter.

🚀 About the Project

The Bleverse Framework for the Next.js

Step into the future with the ultimate Next.js starter. Everything has been set up for you. It's more than just code; it's a journey. You're not on this journey alone. Move faster than ever. It can be proudly called a website builder, although it certainly isn't, at least for now 😏. We've laid the groundwork; now, grab it, dive in and accelerate your development.

This is our experimental space where we tinkered with the new Next.js app directory. So, while it's all fun and exploration, there might be a few quirks here and there. Stumbled upon something odd or just feeling generous? DM us on Twitter, sorry, on X @bleverse_com or raise an issue right here. If you've got some coding magic up your sleeve, contributions are always celebrated! 🎉

🔥 TO-DO Features

Copy. Paste. Ship.

This roadmap outlines the key features and improvements to be implemented in this web project.

• 🌐 Comprehensive offerings of the Next.js app directory.
• 📊 Dive deep into SQL with TypeScript ORM via Drizzle ORM.
• 🔒 Keep it tight with Authentication using Auth.js and Lucia.
• 🌍 Centralized Database magic at PlanetScale.
• ✨ Stunning UI components, all thanks to shadcn/ui.
• 📝 Share insights with Blogs powered by MDX.
• 💲 Seamless Subscriptions via Stripe & LemonSqueezy.
• 🎨 Styled to impress with Tailwind CSS.
• 📡 Data-fetching streamlined with RSCs & tRPC.
• 📧 Email verification and a lot more features to enhance your application!

Configure Your App

The app.ts file contains essential configuration used to modify the contents and settings of the website.

• Manage the content displayed on the website.
• Customize various settings, such as disabling theme toggle.
• Manage general site-wide information.

🏃‍♂️ Getting Started Locally

Get all dependencies sorted:

pnpm install

Get your environment variables in check:

cp .env.example .env

Let the server magic begin:

pnpm dev

📚 Setting Up the Database

On Your Machine

Hop into MySQL:

mysql -u root

Bring your database to life:

CREATE DATABASE template;

Push your DB schema:

npx drizzle-kit mysql:push

🌐 PlanetScale

Thinking of ditching local? Feel free to fully commit to PlanetScale as your primary database!

🔐 Authentication

Setting up GitHub OAuth is a breeze:

1. Visit: https://github.com/settings/developers
2. Hit "New OAuth App".
3. Register your callback URL: http://localhost:3000/api/oauth/github

💌 Email

Want a sneak peek of your email in dev mode without sending it out? Run:

npx mailing

For the real deal in production, you'll be working with Resend. Grab your API key and verify your domain there.

💲 Payments

LemonSqueezy powers payments, with subscription syncs via webhooks (lemonsqueezy/route.ts). Fancy a local test? Expose the webhook with:

npx ngrok http 3000

Then, register the webhook URL, like https://abc.eu.ngrok.io/api/lemonsqueezy, in LemonSqueezy's webhook settings.

🖼️ Asset Generation

For a fresh splash of branding, swap logo-mark.svg with your logo. Then, run:

npm run asset-generator

📫 Contributing to Bleverse Relivator

To contribute to Bleverse Relivator, follow these steps:

1. Fork this repository.
2. Create a branch: git checkout -b <branch_name>.
3. Make your changes and commit them: git commit -m '<commit_message>'
4. Push to original branch: git push origin <project_name> / <local>
5. Create the pull request.

Or, see the GitHub docs on how to create a pull request.

🙌 Kudos to Collaborators

We thank everyone for their contributions to this repository. Please visit the release page to see the full list of contributors and their authors.

License

Released under the MIT license.

---

Happy coding! Embark on this coding adventure, learn, iterate, and most importantly – enjoy the process! And remember – this is a space of learning and experimentation. Dive in and enjoy the journey! 🚀🌌