{"id":30481019,"url":"https://github.com/likeur/rtpa","last_synced_at":"2025-08-24T13:25:13.981Z","repository":{"id":310322017,"uuid":"1037872828","full_name":"Likeur/rtpa","owner":"Likeur","description":"rtpa : ready tailwindcss project assistant, pour t'aider dans la création rapide des projets tailwindcss à partir de la version 4","archived":false,"fork":false,"pushed_at":"2025-08-17T11:12:48.000Z","size":25,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-17T11:19:26.464Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Likeur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-14T08:53:39.000Z","updated_at":"2025-08-17T11:12:52.000Z","dependencies_parsed_at":"2025-08-17T11:19:32.102Z","dependency_job_id":null,"html_url":"https://github.com/Likeur/rtpa","commit_stats":null,"previous_names":["likeur/rtpa"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Likeur/rtpa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Likeur%2Frtpa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Likeur%2Frtpa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Likeur%2Frtpa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Likeur%2Frtpa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Likeur","download_url":"https://codeload.github.com/Likeur/rtpa/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Likeur%2Frtpa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271778235,"owners_count":24819265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-24T13:25:11.462Z","updated_at":"2025-08-24T13:25:13.973Z","avatar_url":"https://github.com/Likeur.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RTPA - Ready Tailwind CSS Project Assistant Creation Tool\n\nRTPA (Ready Tailwind Project Assistant) is a command-line tool designed to simplify the creation of new web projects with **Tailwind CSS** already setup. It supports setting up both simple HTML/CSS projects, modern **Vite.js** based projects such as vanilla Js and **Angular** based project, with automatic Tailwind CSS integration while offering the option to automatically publish it directly to your github.\n\n[![npm downloads](https://img.shields.io/npm/dt/rtpa)](https://www.npmjs.com/package/rtpa)\n![Rtpa](https://img.shields.io/badge/tailwind-css-38B2AC?style=for-the-badge\u0026logo=tailwindcss\u0026logoColor=white)\n[![npm version](https://img.shields.io/npm/v/rtpa.svg)](https://www.npmjs.com/package/rtpa)\n![Licence](https://img.shields.io/badge/licence-MIT-green?style=for-the-badge)\n\n## Features\n\n* **Fast Project Creation:** Launch a new :\n\n    - Simple **HTML/CSS** project.\n\n    - Modern project with **Vite (Vanilla JS)**.\n\n    - Project with the **Angular framework**.\n\n* **Tailwind CSS Integration:** Automatically configures Tailwind CSS v4 for your project adapted on your choosen type.\n\n* **Automatic configuration of a linter and a formatter** (ESLint and Prettier), ensuring code quality and consistency from the start.\n\n* **Command Line Arguments:** Specify project type and name directly from the command line.\n\n* **Git Initialization:** Automatically initializes a local Git repository.\n\n* **GitHub Integration (Optional):** Initializes a GitHub repository and pushes your code (requires a GitHub PAT).\n\n## Installation\n\nTo use RTPA, you need Node.js and npm (or Yarn/pnpm) installed on your machine.\n\n### Global Installation (Optionnal)\n\nUsing npm : you can install it globally:\n\n```bash\nnpm install -g rtpa\n```\n```bash\nyarn global add rtpa\n```\n```bash\npnpm install -g rtpa\n```\n\n## Usage\nYou can use RTPA in several ways:\n\n1. **interactive mode**\nRun the command without any arguments to choose the project type and name via interactive prompts:\n\n```bash\nrtpa\n```\n\n2. **Direct project creation**\nUse the `--js` or `--angular` flags to directly specify the project type. You can also provide the project name immediately after the flag.\n\n- Create a **simple html/css** project:\n\n```bash\nrtpa --simple project-name\n```\n\n- Create a **Vite Vanilla Js** project:\n\n```bash\nrtpa --js project-name\n```\n\n- Create an **Angular** project\n\n```bash\nrtpa --angular project-name\n```\n\nif `project-name` is omitted, the tool will prompt you for it.\nExemple `rtpa --js my-vite-app`\n\n### Usage with npx (Without global installation)\n\nIf you prefer not to install the tool globally, you can use npx to run it directly. This will download and execute the tool without installing it permanently on your system.\n\nTo use ``npx``, simply prepend ``npx`` to the command:\n```bash\nnpx rtpa\n```\n\nThe interactive shell will then guide you through the project creation process. You can also use the command-line arguments with npx:\n\n```bash\nnpx rtpa --simple [project-name]\n```\n```bash\nnpx rtpa --js [project-name]\n```\n```bash\nnpx rtpa --angular [project-name]\n```\n\n## Linter and Formatter Configuration\n\nAfter your project is created, the tool will ask if you want to integrate a linter and a formatter. If you choose to, it will automatically install ESLint and Prettier and set up their basic configuration files (``.eslintrc.js`` and ``.prettierrc.json``). This ensures code consistency and helps catch errors early in the development process.\n\n## Github Configuration\n\nWhen prompted by the tool, you can choose to link your project to a new GitHub repository. You will need to provide a GitHub Personal Access Token (PAT) with repo permission for the tool to create and push the repository on your behalf.\n\n### How to get your personnal token (PAT) ? :\n\n- clic here [personal token settings](https://github.com/settings/tokens).\n\n- clic on \"Generate new token\".\n\n- Choose token(classic)\n\n- give an explicit name to the token (`ex: cli-tailwind-tool`).\n\n- give `repo` permission by checking the repo option.\n\n- Clic on \"Generate token\" and copy and paste your token somewhere accessible because you'll not see it again (save it wisely in a personal file).\n\n\n## Quick Start After Creation\nOnce your project is created, follow the instructions displayed in your terminal.\n\n### For a Simple HTML/CSS Project:\n1. Navigate to your project folder: cd [project-name]\n2. Launch the Tailwind CSS compiler in watch mode: npm run start\n3. Open your index.html file in a web browser to see your live changes.\n\n### For a Vite.js Project:\n1. Navigate to your project folder: cd [project-name]\n2. Launch the Vite development server: npm run dev\n3. Open your browser to the local address indicated by Vite (usually http://localhost:5173/).\n\n## Contribution\nContributions are welcome! Feel free to open issues or submit pull requests.\n\n\n## Note : \n\nyour token is not saved in the code or send somewhere, in order to keep your github account secure.\n\n\ncoded with love by @likeur","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flikeur%2Frtpa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flikeur%2Frtpa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flikeur%2Frtpa/lists"}