summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAnwarul Islam <anwaarulislaam@gmail.com>2025-07-16 04:34:25 +0600
committerAnwarul Islam <anwaarulislaam@gmail.com>2025-07-17 19:46:57 +0600
commitf21b704323b8905f8a64c08feef27820898efc3c (patch)
tree23c5c112aeabab9e4f740e203a8427e024f19a6c
parent7d4cbca1190edc12ff9ae17029613b77b08436e0 (diff)
downloadopencut-f21b704323b8905f8a64c08feef27820898efc3c.tar.gz
docs: update README for clarity on setup instructions
-rw-r--r--README.md19
1 files 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: