LampungDev Web

A modern web platform built for Lampung developers to collaborate, learn, and grow together.

---

🧱 Project Stacks

1. Framework: Next.js 14 App Router
2. CSS: Tailwind CSS
3. UI Components: Shadcn UI
4. Database: PostgreSQL hosted on Supabase
5. ORM: Drizzle ORM
6. JavaScript Runtime: Bun
7. Media Storage & CDN: Cloudinary

---

🧪 Drizzle Workflow

1. Generate:
   Create or update schema definitions based on your database structure.

   bun db:generate

2. Migrate:
   Apply the generated migrations to update your database schema.

   bun db:migrate

3. Push:
   Push schema changes to your database to ensure everything is in sync.

   bun db:push

---

🚀 Getting Started

1. Clone the Repository

git clone [email protected]:Lampung-Dev/lampung-dev-web.git
cd your-repo-name

2. Install Bun

If you don’t have Bun installed, follow the Bun installation guide.

3. Install Dependencies

bun install

4. Create Environment Variables

cp .env.example .env

Then update the .env file with your credentials. For detailed environment setup, check ENV_SETUP.md.

5. Create a New Branch

git checkout -b your-branch-name

💡 Branch Naming Conventions:

• feature/your-feature
• fix/your-fix
• enhancement/your-enhancement
• chore/your-task

Examples:

• feature/new-homepage
• fix/login-bug
• enhancement/cart-ui

6. Run the Development Server

bun run dev

7. Seed Your Database (Optional)

To populate your local database with sample data, run the seed script:

bun run seed

This script supports the following options:

• --refresh: Clears existing user and social media data before seeding.
• --count <number>: Specifies the total number of users to generate.

Examples:

• To start fresh and create 20 sample users:

  bun run seed -- --refresh --count 20

• To add 5 more users to the existing data:

  bun run seed -- --count 5

8. Push Your Changes

git push origin your-branch-name

9. Open a Pull Request

Submit a pull request to the development branch and wait for review.

---

👥 Contributing

We welcome contributions! 🙌

To contribute:

1. Check existing issues or create a new one.
2. Comment if you want to work on something.
3. Follow the branch/PR guide above.
4. Submit your PR and we’ll review it together.

For major changes, open an issue first to discuss the idea.

---

💬 Community

Got questions, ideas, or just want to chat?

• Join our Discord: LampungDev Discord
• Telegram Group: LampungDev Telegram
• Whatsapp Group: LampungDev Whatsapp

---

📄 License

This project is licensed under the MIT License.

---

💡 Credits

Made with ❤️ by the LampungDev community.