|
1 | | -This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app). |
| 1 | +# DevSetup |
2 | 2 |
|
3 | | -## Getting Started |
| 3 | +## Introduction |
4 | 4 |
|
5 | | -First, run the development server: |
| 5 | +**DevSetup** is a web application designed to help developers quickly generate installation scripts for their development environment. By selecting the operating system (Windows, macOS, or Linux) and package manager (e.g., Chocolatey, Homebrew, APT), developers can easily choose the tools they need and generate a script to install them. |
6 | 6 |
|
7 | | -```bash |
8 | | -npm run dev |
9 | | -# or |
10 | | -yarn dev |
11 | | -# or |
12 | | -pnpm dev |
13 | | -# or |
14 | | -bun dev |
15 | | -``` |
| 7 | +Whether you’re setting up a new machine or just need to install a set of tools, DevSetup streamlines the process by automating the creation of installation scripts. |
| 8 | + |
| 9 | +## Features |
| 10 | + |
| 11 | +- **Select OS and Package Manager**: Choose between Windows, macOS, or Linux and then select your preferred package manager. |
| 12 | +- **Tool Selection**: Browse a variety of development tools categorized by type and select the ones you need. |
| 13 | +- **Script Generation**: Automatically generate a script based on your selections. |
| 14 | +- **Copy & Download**: Copy the generated script to the clipboard or download it as a file. |
16 | 15 |
|
17 | | -Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. |
| 16 | +## Tech Stack |
18 | 17 |
|
19 | | -You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file. |
| 18 | +- **Frontend**: React (with hooks), TypeScript |
| 19 | +- **Excel Parsing**: [XLSX.js](https://github.com/SheetJS/sheetjs) |
| 20 | +- **CSS**: TailwindCSS (for styling) |
20 | 21 |
|
21 | | -This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel. |
| 22 | +## How It Works |
22 | 23 |
|
23 | | -## Learn More |
| 24 | +1. **Load Tools Data**: The app loads a list of tools and their installation commands from an Excel file (`tools.xlsx`). |
| 25 | +2. **Tool Categories**: Tools are grouped into categories such as 'Development', 'Databases', 'Web Servers', etc. |
| 26 | +3. **OS and Package Manager Selection**: The user selects their operating system (Windows, macOS, Linux) and package manager (e.g., `choco`, `winget`, `apt`, etc.). |
| 27 | +4. **Tool Selection**: The user selects tools they want to install from a variety of categories. |
| 28 | +5. **Script Generation**: The app generates a script with the corresponding installation commands for the selected tools and package manager. |
| 29 | +6. **Copy/Download**: The generated script can be copied to the clipboard or downloaded as a `.sh` file. |
24 | 30 |
|
25 | | -To learn more about Next.js, take a look at the following resources: |
| 31 | +## Demo |
26 | 32 |
|
27 | | -- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API. |
28 | | -- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial. |
| 33 | +Visit our website to try the tool live: |
29 | 34 |
|
30 | | -You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome! |
| 35 | +[DevSetup Demo](https://devsetup.example.com) *(Replace with the actual URL once live)* |
31 | 36 |
|
32 | | -## Deploy on Vercel |
| 37 | +## Installation |
33 | 38 |
|
34 | | -The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js. |
| 39 | +### Clone the Repo |
35 | 40 |
|
36 | | -Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details. |
| 41 | +To run **DevSetup** locally, clone the repository and install dependencies: |
| 42 | + |
| 43 | +```bash |
| 44 | +git clone https://github.com/yourusername/devsetup.git |
| 45 | +cd devsetup |
| 46 | +npm install |
0 commit comments