KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#codex #developer-tools #typescript #ai-agents #claude-code #python #mcp #react #cli #macos #ai-agent #deepseek-harness

mikey

★ 46 Open GitHub ↗

Moved To: https://gitlab.com/mikeysax/mikey

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mikey

# Latest Repository Is Located On [Gitlab](https://gitlab.com/mikeysax/mikey)

---
### _Mikey_ is a React-Redux framework for generating React-Redux projects and React-Redux files.

Inspired by Rails generate; _Mikey_ is a CLI / Framework for React/Redux
applications. _Mikey_ was designed to be simple, intuitive to use, and increase
development speed and productivity of React/Redux applications. _Mikey_ can
generate React/Redux projects and files, saving the developer valuable time that
can be spent building features. _Mikey_ can also be used in most React/Redux
projects and is intended to be a broad solution.

![](https://raw.githubusercontent.com/Mikeysax/mikey/master/screenshot.png)

Example Applications:

[Regular Mikey Example](https://github.com/otis-bot/otis-frontend)

[React Mikey Example (No Redux Coming Soon!)]()

[Universal Mikey Example](https://github.com/Mikeysax/mikeyUniversalExample)

---

### Installation

To Install _Mikey_:

`$ npm install mikey -g`

To see a list of commands:

`$ mikey`

---

### Project Generation

To Generate a new project:

`$ mikey new projectType`

The different project types are:

`react` : react(no redux).

`redux` : react-redux

`universal` : react-redux, with server rendering. This also has an API option
which is setup to use Sequelize and Postgresql out of the box.

After the new command, _Mikey_ will ask for the project name.

When you create a new project, _Mikey_ will run `npm install` automatically in
the created project directory. All you have to do is be patient.

---

Once `npm install` is done, `cd` to project and start the server with:

React and React-Redux Projects: `$ npm start`

Universal projects: `$ npm run dev`

---

_Mikey_ projects are compatible with React / Redux Dev Chrome Extensions and hot
reloading is enabled. Dependencies are kept as minimal as possible. _Mikey_ also
contains Babel for ES6 compatibility, SCSS/CSS/Image loaders, Testing Setup with
Enzyme and other testing dependencies, Production/Dev Config, and Source
Mapping. Universal projects take advantage of Redux Async Connect /
Redux-Connect fork to pre-load data onto the server before rendering. Almost
every project template uses Webpack 2.

---

To build for production:

`$ npm run build`

---

### File Generation

To generate a new react file:

`$ mikey g fileType`

Pick any filetype: container / component / action / helper / reducer

Mikey will ask you for a file name after you choose a filetype.

Custom Files(section blow):

`$ mikey g custom`

Use these commands in the root of your project.

---

#### _Mikey_ classification and description of file type:

[Containers](http://redux.js.org/docs/basics/UsageWithReact.html)
are components which connect to your store. Containers should act as further
separation of logic and view.

[Components](http://redux.js.org/docs/basics/UsageWithReact.html)
are primarily the view layer and rendered inside of Containers.

[Reducers](http://redux.js.org/docs/basics/Reducers.html) are
responsible for updating the state of your application. Reducers are pure
functions, meaning they do not mutate the state. Reducers take the current state
and return a new state object.

[Actions](http://redux.js.org/docs/basics/Actions.html) are
dispatched with a type and payload. Actions work with Reducers in updating the
application store. Actions can contain Ajax requests or new information
generated by a User.

Helpers are used for organizing random methods which can
clutter your Containers and Components. Using helpers enable you to reuse
methods over and over throughout your project (DRYer).

---

##### On File Creation Specifics:

On file creation, _Mikey_ will look through your working project directory for
actions/components/containers/reducers/helpers folders and create the
corresponding file type. If none of these folders exist, _Mikey_ will create the
file in the root of your project.

_Mikey_ will also generate a .scss file in the CSS folder when you generate a
component or container.

_Mikey_ also creates `.mikeyPath` folder in your project and
saves the path of the file type generated. This is to optimize the speed of file
creation. By saving this path _Mikey_ does not have to dynamically find the
folder again after each generated file.

A Test file is also generated when you generate a file.

If your project directory changes at all, delete `.mikeyPath` folder to recache
folder paths. `.mikeyPath` folder is added to `.gitignore` also.

You cannot create files that already exist. _Mikey_ will prevent you
from overwriting files you have already generated.

---

### mikey.json Details

On file generation, _Mikey_ will check the root of your project to see if a
`mikey.json` file exists. If `mikey.json` does not exist it will be generated.

Inside `mikey.json` contains settings for css generation, css folder name, css
extension, and testing generation.

* css: Can be set to a boolean and determines if _Mikey_ should generate a css
  file.

* cssFolder: Can be set to the name of the folder that contains your CSS files.

* cssExtension: This determines what extension the CSS files _Mikey_ generates
  will have.

* testing: Can be set to a boolean and determines if _Mikey_ should generate a
  test.

---

### Adding Imports on File Generation

To generate a new file and import one or multiple dependencies to top of
file:

`$ mikey g fileType -i depName`

To import multiple dependencies to top of file:

`$ mikey g fileType -i depName -i depName -i depName`

To import with curly brackets:

`$ mikey g fileType -i {connect},react-redux`

You can import with a comma and it will split it correctly:

`import {connect} from 'react-redux';`

If the imports are not currently listed in your projects `package.json` file
dependencies, they will be automatically installed by `npm`.

---

### Defaults

_Mikey_ will remember previous imports and store them as
defaults for each file type. Stored imports are only stored once per file type.

You can include defaults by typing `-d Y` (for Yes) for using defaults, at the
end of the generation command:

`$ mikey g fileType -d Y`

If the defaults are not currently listed in your projects `package.json` file
dependencies, they will be automatically installed by `npm`.

---

#### To list defaults:

`$ mikey list fileType` | `$ mikey -l fileType`

If you want to list all stored defaults:

`$ mikey list all` | `$ mikey -l all`

---

#### To erase defaults:

`$ mikey erase fileType` | `$ mikey -e fileType`

If you want to erase all stored defaults:

`$ mikey erase all` | `$ mikey -e all`

---

### Custom Templates

#### Saving Custom Templates:

_Mikey_ will allow you to save your projects react file as a
template. The file you wish to save should be in your current project. Create a
file in containers / components / reducers / actions / helpers folders and use
the:

`$ mikey save_template fileType`

This command will save the file inside of _Mikey_ as a custom template. File
selection is without the .js extension. A list of files you can
save will be displayed.

---

#### Generating Custom Files from Custom Templates:

Once you've saved a template, you can reuse it in any project.

`$ mikey g fileType`

A list of custom templates of that file type will display. A prompt will display
in the console for template choice and desired file name. The template file name
will be used by default if no new name is entered. File selection is
without the .js extension

---

#### Deleting Custom Files from Custom Templates:

If you want to delete a custom template:

`$ mikey delete_template fileType`

A list of custom templates of that file type will display. The prompt will then
ask which file you would like to delete. File selection is without the
.js extension

---

#### List Custom Files from Custom Templates:

If you would like to look at saved custom templates:

`$ mikey list_templates fileType`

This will display all saved custom templates for current file type.

---

### Contribute

If you would like to contribute, it would be greatly
appreciated.

---

#### For help and more commands:

`$ mikey -h` | `$ mikey -V` | `$ mikey`

---

#### Version History:

3.10.3: Updated Universal API Templates to use latest React and
updated server side rendering setup with Hydrate and NodeStream. Improved
Webpack config as well. Refactored pieces of mikey and implemented use of yarn
to install project dependencies.

3.9.7: _Mikey_ Universal API Template uses sequelize by default
instead of waterline. Cleaned up README.

3.9.5: _Mikey_ now uses `npm` to install project dependencies.
With the advent of npm 5 and the progrssive enhancements will also prevent other
possible errors from occuring on project generation.

3.9.2: _Mikey_ now uses `yarn` to install project dependencies,
greatly decreasing the time it takes to generate a full project. All projects
besides Electron, use Webpack 2. Installing dependencies on file generation will
now use yarn.

3.8.0: _Mikey_ Universal projects are now updated to
Webpack 2. Universal projects also have an API version which
are setup to use Waterline and Postgresql out of the box. There are also
examples of user authentication using JSON web tokens which can serve as a guide
or be used.

3.7.1: _Mikey_ now automatically adds an import statement to
App.js for generated CSS files. _Mikey_ also has many more edge cases covered
when generating a project or file to prevent accidental creation of files with
no names and project with incorrect project types. Also, null or undefined paths
will not be saved to .mikeyPath anymore.

3.6.1: _Mikey_ now creates a `mikey.json` file in the root of
your project to determine css style settings/generation and testing generation.

3.5.0: Generated mikey projects auto import all CSS files. On
file generation for components and containers a .scss file will be created with
the same name in snake_case.

3.4.6: Complete refactor of file generation into one command.

3.3.1: Complete refactor of project generation into one
command.

3.2.0: `mikey` installs dependencies from importing via file
generation and using defaults.

3.1.0: Added React (Without Redux) project generation with
`mikey react projectName`. This project is the only project which does not
contain Redux.

3.0.5: Added Electron project generation with `mikey electron
projectName`. For more information consult the readme file in a generated
Electron project.

2.1.6: Added Universal / Isomorphic project generation with
`mikey universal projectName`. The Universal template uses redux-connect
package, a fork of Redux Async Connect package, to pre-load data from AJAX calls
onto the server. For examples you can take a look at the example from of how to
use this feature.

1.7.3: Added more test templates. Test template is chosen based
on which file you are generating. Fixed README and added LICENSE text. Removed
some console.log statements which were redundant. Changed helper template to
contain basic const.

1.6.3: Added Custom Template
generation/saving/deletion/listing. Refactored file generation to be DRY'er.
When you deal with custom templates, prompts will be given to obtain more
details about files. List is displayed on template deletion command. Ability to
save a file in current project to reuse.

1.5.0: Changed Project generation to `spawn` instead of `exec`.
Added some fun tidbits like colors and art to project generation. Refactored
project generation to be cleaner and output more helpful information. Updated
project template dependencies.

1.4.4: Mikey displays help when just typing `mikey`. Modified
Project Template App.js and store.js file to be more logical. Added actions
index to import all actions to.

1.3.6: Generating files also generate corresponding tests.
Switched testing files to .test.js to keep with consistency of other aspects of
mikey. Previous generated projects will need to switch test script in
package.json to be compatible with newly generated tests. Added new container
template.

1.2.4: Project Template uses enzyme for testing.

1.1.8: New CLI Commands which are direct and logical, testing
integrated in Project Creation Template. README reflects all changes for New CLI
Commands and movement towards _Mikey_ as a Framework.

1.0.0: New Project Creation Template with More Concise
Documentation.

mikey

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README