Skip to content

Repository files navigation

Certainly. Below is an updated README.md reflecting the inclusion of Bun as the primary package manager and runtime, along with other essential technologies used in your CosmoStack starter template.

🌌 CosmoStack

CosmoStack is a modern, opinionated React starter template engineered for building scalable, performant, and maintainable frontend applications. It leverages a curated selection of best-in-class tools and libraries, optimized for developer productivity and type safety.


⚙️ Tech Stack

  • React – Declarative UI library
  • 🧠 TypeScript – Static typing for safer, scalable code
  • 🔁 React Router v6+ – Modern client-side routing with nested layouts
  • 📡 TanStack Query (React Query) – Data fetching and caching
  • 🎨 Tailwind CSS v4 – Utility-first CSS for rapid UI development
  • Bun – All-in-one JavaScript runtime with built-in bundler

📁 Directory Structure

src/
├── components/        # Shared and reusable UI components
├── pages/             # Route-based page components
├── layouts/           # UI layout components
├── hooks/             # Custom React hooks
├── lib/               # API utilities and fetch logic
├── router/            # Router configuration
└── main.tsx           # Application entry point

🛠 Getting Started

1. Prerequisites

Ensure you have Bun installed globally:

curl -fsSL https://bun.sh/install | bash

2. Clone the Repository

git clone https://github.com/yeasinat/CosmoStack.git
cd CosmoStack

3. Install Dependencies

bun install

4. Start Development Server

bun dev

📦 Build for Production

bun run build

🧪 Planned Enhancements

  • Centralized API abstraction layer.
  • Authentication and protected route logic.
  • State management integration (e.g., Zustand).
  • Continuous Integration and Deployment workflows (CI/CD).
  • Automated testing framework (unit and end-to-end testing).

About

Frontend starter template with React

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages