namaste-react
Version:
a npm package to create a simple react app
103 lines (68 loc) β’ 3.02 kB
Markdown
# Namaste React π
Namaste React is a powerful tool designed to kickstart your React projects with ease! π This package sets up a React project template using Parcel, offering a clean and efficient starting point for your web applications. Available on [npm](https://www.npmjs.com/package/namaste-react)! π
## π Getting Started
To create a new React project using Namaste React, follow these simple steps:
1. **Install the Package:**
```bash
npx namaste-react my-new-project
```
Replace `my-new-project` with your desired project name.
2. **Navigate to Your Project Directory:**
```bash
cd my-new-project
```
3. **Start the Development Server:**
```bash
npm start
```
Visit [http://localhost:1234](http://localhost:1234) in your browser to see your new React app in action!
4. **Build for Production:**
```bash
npm run build
```
## π οΈ Tech Stack
- `React`: A JavaScript library for building user interfaces.
- `Parcel`: A fast, zero-configuration web application bundler.
- `Tailwind CSS`: A utility-first CSS framework for rapid UI development.
## π Project Structure
Hereβs a brief overview of the project structure:
```bash
my-new-project
βββ src
β βββ index.html # Main HTML file
β βββ index.tsx # React entry point in TypeScript
β βββ styles.css # Tailwind CSS import
βββ .gitignore # Git ignore file
βββ tsconfig.json # TypeScript configuration
βββ package.json # Project metadata and dependencies
βββ tailwind.config.js # Tailwind CSS configuration
βββ README.md # This README file
```
## π§© Example
Hereβs a quick example of a simple React component included in the template:
```js
// src/index.js
import React from "react";
import ReactDOM from "react-dom";
import "./styles.css";
const App = () => (
<div>
<h1>Hello, Namaste React! π</h1>
</div>
);
ReactDOM.render(<App />, document.getElementById("root"));
```
## π‘ Features
- `Zero Configuration`: Start coding right away with Parcelβs zero-configuration setup.
- `React Ready`: Pre-configured with React and ReactDOM.
- `Tailwind CSS`: Utility-first CSS framework for rapid UI development.
- `TypeScript Support`: Type safety with TypeScript to catch errors early.
## π Documentation
For more details, check out the [Namaste React npm package](https://www.npmjs.com/package/namaste-react) and the official [Parcel documentation](https://parceljs.org/).
## π€ Contributing
Contributions are welcome! If you find a bug or have suggestions for improvements, please open an issue or submit a pull request.
## π§ Contact
Feel free to reach out if you have any questions or need help:
- Author: [Prahlad Inala](https://beta.prahladinala.in/)
- GitHub: [@prahladinala](https://github.com/prahladinala)
Happy coding! π