From f21b704323b8905f8a64c08feef27820898efc3c Mon Sep 17 00:00:00 2001 From: Anwarul Islam Date: Wed, 16 Jul 2025 04:34:25 +0600 Subject: [PATCH] docs: update README for clarity on setup instructions --- README.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index ad9a6d38..2f613c89 100644 --- a/README.md +++ b/README.md @@ -40,10 +40,15 @@ Before you begin, ensure you have the following installed on your system: - [Bun](https://bun.sh/docs/installation) -- [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) - [Node.js](https://nodejs.org/en/) (for `npm` alternative) -### Setup +**Additional requirements for full-stack development:** + +- [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) (only needed for database/auth features) + +### Frontend-only Development (Recommended for UI work) + +If you're working on the UI/frontend and don't need authentication or database features: 1. Fork the repository 2. Clone your fork locally @@ -51,15 +56,13 @@ Before you begin, ensure you have the following installed on your system: 4. Install dependencies: `bun install` 5. Start the development server: `bun dev` -## Development Setup +The application will be available at [http://localhost:3000](http://localhost:3000). -### Prerequisites +**Note:** This setup runs without Docker and is perfect for frontend development, UI improvements, and most feature work. -- Node.js 18+ -- Bun (latest version) -- Docker (for local database) +### Full Development Setup (Database + Auth) -### Local Development +Only follow this if you need to work with authentication, user accounts, or database features. 1. Start the database and Redis services: